Съдържание на курса
Урок 03 — Приложението опознава Firebase
От Dorian Chávez · съосновател и Chief Executive Officer на Hábil ·
Преди да четете, четири думи. По един ред за всяка; останалите идват на стъпката, където се използват.
- Firebase: услуга на Google, която върши вместо вашето приложение неща, които не възнамерявате да програмирате, например да помни кой е влязъл. В тази поредица използвате само една нейна част, Authentication.
- Сертификат за отстраняване на грешки (debug): документът, с който Android подписва приложението, което компилирате на вашия компютър. Създава се сам и всеки компютър има свой.
- Отпечатък (SHA-1): кратко резюме на този сертификат. Служи да го разпознаете, без да показвате нищо частно.
google-services.json: конфигурационният файл, който изтегляте от Firebase, с данните на вашия проект и на вашето приложение.
Какво отнасяте: приложението на магазина, свързано с вашия проект във Firebase, с конфигурационен файл, който съдържа всичко необходимо на урок 04, и умението да го проверите, без да отваряте конзолата.
Новата идея на този урок: приложението се свързва с външна услуга чрез две отличителни данни: името на пакета си и отпечатъка на своя сертификат. Услугата не познава вашия код: познава тези две данни. Останалото —приставката на Gradle и библиотеката— идва готово и обяснено и тук не се оценява.
Бележка за текстовете на приложението. Проектът на курса носи текстовете си на екрана на испански, а файловете в
lecciones/ не са преведени: автоматичните проверки на курса (verifica) търсят точно тези текстове. Затова в
блоковете с код, в изходите на терминала и в скиците на екрани текстовете остават такива, каквито са в проекта, а в
прозата урокът ги дава на български и първия път поставя оригинала в скоби: екранът „Магазинът“ (в проекта: „La
tienda“) с бутона „Вход“ (в проекта: „Entrar“) и бутонът „Вход с Google“ (в проекта: „Entrar con Google“).
Сцената
Регистрирате приложението си във Firebase. Помощникът ви предлага един бутон: изтегляне на google-services.json.
Изтегляте го, слагате го в папката му и компилирате.
Компилира се. Всичко е зелено.
Един урок по-късно слагате бутона „Вход с Google“, натискате го и не влизате. Съобщението не казва какво липсва.
Това се случи при изпробването на тази поредица на 13 ноември 2026 г., на Mac: файлът, изтеглен преди да регистрирате отпечатъка и да включите Google, не съдържаше два блока, от които бутонът се нуждае. Това е видяното в онзи ден, а не правило, което Firebase публикува. Устойчивото правило си е в документацията му: след като регистрирате отпечатъка и включите Google, изтегляте обновения файл, защото точно той съдържа необходимото за вход с Google.
А частта „компилира се зелено“ е измерена тук, с измислен файл, на който липсват тези блокове (18 ноември 2026 г.):
./gradlew assembleDebug завършва успешно, а verifica на този урок дава 15 от 18, с три червени знака, които
казват „изтеглете го отново“.
Файлът е копие на онова, което конзолата знаеше за вашето приложение в момента, в който го изтеглихте. Затова редът има значение. Първо опознавате двете отличителни данни на приложението си, после следвате реда, който работи, а накрая го чупите сами, за да прочетете грешката.
Преди да започнете
Какво ви трябва: завършеният урок 02, средата от урок 00
(със зададен ANDROID_HOME) и собствен акаунт в Google. Ще влезете с него в конзолата на Firebase от браузъра си: важи
онова, което е казано за „Акаунт и доверен компютър“ в урок 00.
Какво е ваше. Проектът във Firebase го създавате вие, със своя акаунт, и никой друг не го използва. При изпробването на 13 ноември 2026 г. беше създаден в безплатния план, без регистриране на карта.
Началният проект. От корена на хранилището на поредицата:
git pull
cd lecciones/03-la-app-conoce-a-firebase/inicio
Там работите. До него е solucion/: можете да я четете и сравнявате, без да настройвате нищо. ./verifica solucion
излиза червено в чисто копие (клонинг) на хранилището, и това се очаква: вашият файл не се качва, а с приложената приставка проектът не се
компилира без него (измерено на 18 ноември 2026 г.: 0 изпълнени теста). Ако искате да я прегледате, копирайте файла си
в solucion/app/ —и там е игнориран— и го махнете, като приключите. Предвижданията и обясненията ви отиват в
respuestas/03.md, в корена на хранилището (mkdir -p respuestas, ако не съществува).
Какво вече носи проектът (скелето). Тук не се оценява:
| Какво носи | Къде | Защо |
|---|---|---|
| Трите екрана от урок 02 и седемте им теста | app/src/main и app/src/test |
Тръгвате от онова, което вече сте написали. Свързването на Firebase не бива да ги променя |
| Тестовете на конфигурацията и техният проверител | app/src/test/…/ConfiguracionTest.kt и RevisorDeConfiguracion.kt |
Те са тези, които пуска verifica. Не ги променяйте |
| Три измислени конфигурации | app/src/test/resources/configuraciones/ |
С тях тестовете показват, че проверителят наистина различава пълен файл от непълен |
| Образец на файла, без ничии данни | app/google-services.json.example |
За да знаете как изглежда пълен, преди да имате свой |
Какво не прави този урок. Още няма бутон за Google и никой не влиза: това е урок 04. Тук приложението просто бива запознато с Firebase, а вие го проверявате, като четете файла си.
Стъпка 1 · Без ИИ: двете отличителни данни на приложението ви
Тази стъпка е ваша, без Claude Code. Firebase ще ви поиска две данни. И двете вече съществуват на вашия компютър.
Първата: името на пакета. Предвидете къде е записано и после го потърсете:
grep -n "applicationId" app/build.gradle.kts
Трябва да отговори с един ред: applicationId = "mx.habil.ejemplo.tienda". Според документацията на Android този
идентификатор отличава приложението ви в телефона и в магазина за приложения, а онова, което много инструменти
наричат „име на пакета“, всъщност е тази стойност.
Втората: отпечатъкът. Android не инсталира приложение без подпис. Това, което компилирате за проба, се подписва само, със сертификат за отстраняване на грешки (debug), който инструментите създават във вашата лична папка. Поискайте от Gradle отчета:
./gradlew signingReport
Ето какво даде на 18 ноември 2026 г. (тук с покрит отпечатък; вашият има 20 двойки):
Variant: debug
Config: debug
Store: ~/.android/debug.keystore
Alias: AndroidDebugKey
MD5: …
SHA1: XX:XX:XX:…
SHA-256: …
Valid until: domingo, 5 de noviembre de 2056
----------
Variant: release
Config: none
Прочетете три реда:
Variant: debugе приложението за проби, онова, което инсталирате сinstallDebug. Редът муSHA1е отпечатъкът, който ще регистрирате. Копирайте го вrespuestas/03.md.Storeказва от кой файл е излязъл: хранилището за ключове (keystore) за отстраняване на грешки на този компютър.Variant: releaseказваConfig: none: този проект още няма с какво да подпише версия за публикуване. Това е темата на упражнение 3.3.
Предвидете. Вашата колежка изпълнява същата команда, със същия проект, на своя компютър. Излиза ли ѝ същият отпечатък? Напишете да или не, и защо, преди да продължите.
Отпечатъкът може да се показва; ключът не. Документацията на Android ги разделя така: сертификатът и неговият отпечатък са направени да се споделят с услугите, които ги искат; ключът за подписване и паролите му се пазят в тайна. Keystore за отстраняване на грешки служи само за разработка: същата документация казва, че е нарочно несигурно и че затова магазините не приемат приложение, подписано с него.
Доказва се с: копирания ви отпечатък за отстраняване на грешки и написаното ви предвиждане (основа на цели 3.1 и 3.3).
Стъпка 2 · Без ИИ: какво не се качва
Също без Claude Code и преди да имате файла: така няма дори минута, в която git да може да го отнесе.
Създайте файла .gitignore в папката inicio/, с тези два реда:
# Вашата конфигурация на Firebase: всеки има собствен проект.
google-services.json
Проверете го. Тази команда пита git дали би игнорирал файла и по кое правило (само гледа):
git check-ignore -v app/google-services.json
Трябва да се появи един ред с вашия файл .gitignore, ред 2, правилото google-services.json и пътя
app/google-services.json. Началото на реда се променя според това откъде пускате git; от inicio/, на 18 ноември
2026 г. беше така:
lecciones/03-la-app-conoce-a-firebase/inicio/.gitignore:2:google-services.json app/google-services.json
Хранилището на поредицата вече носеше същото правило в корена си; git ви докладва най-близкото до файла, а то е вашето. Вашето е това, което пази проекта в деня, когато заживее в собствено хранилище.
Защо не се качва, казано внимателно. Не защото е тайна. Документацията на Firebase казва, че този файл носи уникални, но не тайни идентификатори и че API ключовете му само идентифицират вашия проект: данните ги пазят правилата за сигурност, разрешенията и App Check. В тази поредица остава извън хранилището по друга причина: всеки има собствен проект. Ако качите своя, приложението на колежката ви ще говори с вашия Firebase и с отпечатък, който не е неин.
Онова, което никога не се качва, в никое хранилище:
- Ключовете за подписване (файлове
.jksили.keystore) и паролите им. - Пароли, на каквото и да е.
- Тайният ключ на Microsoft, който ще създадете в урок 05.
Доказва се с: вашето обяснение в respuestas/03.md (цел 3.2). verifica само проверява, че редът е във вашия
.gitignore, че образецът .example съществува и че git не следи никакъв google-services.json.
Стъпка 3 · В конзолата: редът, който работи
Още две думи, които сега ще видите изписани:
- OAuth: споразумението, с което приложение моли Google да потвърди кой сте, без да вижда паролата ви. Използвате го в урок 04; днес само подготвяте данните му.
- OAuth клиент: картата, по която Google разпознава приложение, което ще поиска това.
Отворете app/google-services.json.example. Така изглежда пълен файл. Намерете два блока в oauth_client: онзи със
"client_type": 1, с certificate_hash, и онзи със "client_type": 3. Първият е клиентът за Android, с вашия
отпечатък; вторият, уеб клиентът.
Първо предвидете. Ако изтеглите файла веднага след регистрирането на приложението, преди да дадете отпечатъка и да включите Google, кои от тези блокове бихте очаквали да намерите? Запишете го.
Сега следвайте този ред в конзолата на Firebase. Редът е този от изпробването на 13 ноември 2026 г. Имената на менютата и бутоните са такива, каквито ги пише документацията на Firebase към 18 ноември 2026 г., на английски; конзолата може да ги показва преведени или да ги е преместила.
- Създайте проекта. При създаването конзолата предлага две неща, които документацията отбелязва като по желание: своята помощ с изкуствен интелект и Google Analytics. Изключете и двете: тази поредица не ги използва.
- Регистрирайте приложението за Android. В „Android package name“ се пише
mx.habil.ejemplo.tienda, копирано точно. Документацията предупреждава, че различава главни и малки букви и че не може да се променя след регистрирането: с друго име трябва да регистрирате друго приложение. При изпробването помощникът не поиска отпечатъка и предложи да изтегли файла. Още не го изтегляйте. - Добавете отпечатъка. В „Project settings“, на картата „Your apps“, изберете приложението си, натиснете „Add
fingerprint“, поставете
SHA1от стъпка 1 и запазете („Save“). - Включете Google. Документацията го поставя в „Security > Authentication“, раздел „Sign-in method“: включете доставчика Google и запазете. При изпробването поиска публично име за проекта и имейл за поддръжка: използвайте този на вашия акаунт.
- Чак сега изтеглете
google-services.json, от същата карта „Your apps“, и го сложете вinicio/app/. Документацията съветва да се пази само най-новият файл.
Само едно място. Приставката приема и по един файл за всеки вариант, например в app/src/debug/. Тази поредица
използва само app/google-services.json, за да има един-единствен файл за проверка, а verifica не гледа другите
папки: с файла другаде излиза червено, дори проектът да се компилира (измерено на 18 ноември 2026 г.: 12 от 18, със
съобщение къде го е намерил).
Проверете го, без да отваряте конзолата. От корена на хранилището:
./lecciones/03-la-app-conoce-a-firebase/verifica
В този момент вървите добре, ако знаците за вашия файл са зелени и червени остават само тези от стъпка 4. С пълен измислен файл това даде на 18 ноември 2026 г. (съкратено):
✅ Texto: tu app/google-services.json nombra el paquete mx.habil.ejemplo.tienda
✅ Simulado: una app de tu archivo es del paquete mx.habil.ejemplo.tienda
✅ Simulado: tu archivo trae un cliente de OAuth de Android (tipo 1)
✅ Simulado: ese cliente trae la huella SHA-1 del almacén de depuración de esta computadora
✅ Simulado: tu archivo trae un cliente de OAuth web (tipo 3), el que usará el botón de Google en la lección 04
❌ La app compilada no lleva el project_id y el google_app_id de tu archivo: falta aplicar el plugin …
❌ Ninguna librería de Firebase está entre las dependencias de la app, o no arrancó con el proyecto …
❌ Falta Authentication: la app no trae firebase-auth entre sus dependencias. El BoM no la agrega: …
Resultado: 15 de 18 pruebas en verde (3 en rojo, 0 con error, 0 saltadas), leído de …
(Това е изходът на verifica, точно както го печата скриптът, на испански. На български знаците казват: вашият файл
назовава пакета; приложение във вашия файл е от пакета; вашият файл носи OAuth клиент за Android (тип 1); този клиент
носи SHA-1 отпечатъка на keystore за отстраняване на грешки на този компютър; вашият файл носи уеб OAuth клиент
(тип 3), онзи, който бутонът за Google ще използва в урок 04; и, в червено: компилираното приложение не носи
project_id и google_app_id от вашия файл, липсва приставката; никоя библиотека на Firebase не е сред зависимостите
на приложението; липсва Authentication, приложението не носи firebase-auth, а BoM не я добавя. Резултат: 15 от 18
теста са зелени.)
Ако вместо това видите „descárgalo otra vez después de la huella“ (изтеглете го отново след отпечатъка), файлът е бил изтеглен твърде рано: повторете точка 5. Не е нужно да изтривате нищо в конзолата.
Какво сравнява знакът за отпечатъка. Тестът отваря keystore за отстраняване на грешки на вашия компютър, изчислява неговия SHA-1 и го търси във вашия файл. Не пита Firebase за нищо.
Доказва се с: четирите знака „Simulado“ за вашия файл казват какво носи файлът (цел 3.5). Че сте следвали реда в собствения си проект, никой локален тест не може да види: това се потвърждава, когато влезете, в урок 04.
Стъпка 4 · С Claude Code: приставката и библиотеката
Файлът ви вече е в папката си, а приложението още не го чете. Липсват две части от скелето:
| Част | Какво прави | Кога работи |
|---|---|---|
Приставката google-services |
Чете вашия google-services.json и го превръща в ресурси, които приложението ще може да чете. Според документацията ѝ може да добавя и основни зависимости за включените от вас услуги |
При компилиране. Не се изпълнява като код в телефона |
BoM на Firebase и firebase-auth |
BoM е списък от версии, които работят заедно: фиксирате само една, а библиотеките са без версия. firebase-auth е тази на Authentication и е тази, която дава функциите при изпълнение |
Вътре в приложението |
Тук влиза инструментът и влиза винаги по един и същ начин: предвиждате → искате → четете какво е генерирал →
пускате verifica → обяснявате със свои думи.
- Предвидете. Запишете в
respuestas/03.md: кои файлове ще се променят? Някой от тях.ktли е? - Поискайте от Claude Code, стоейки в
inicio/: „Вgradle/libs.versions.tomlдобави приставкатаcom.google.gms.google-servicesвъв версия 4.6.0 и BoM на Firebasecom.google.firebase:firebase-bomвъв версия 35.2.0, с библиотекатаfirebase-authбез версия. Декларирай приставката вbuild.gradle.ktsв корена сapply falseи я приложи вapp/build.gradle.kts; в същия файл добави BoM иfirebase-auth. Не променяй никакъв файл.kt, нито тестовете, нитоapp/google-services.jsonи не копирай никаква стойност от този файл никъде другаде.“ - Прочетете цялата промяна, преди да я приемете. Трябва да са три файла, с тези части:
# gradle/libs.versions.toml — по един нов ред във всяка секция
[versions]
googleServices = "4.6.0"
firebaseBom = "35.2.0"
[libraries]
firebase-bom = { group = "com.google.firebase", name = "firebase-bom", version.ref = "firebaseBom" }
firebase-auth = { group = "com.google.firebase", name = "firebase-auth" }
[plugins]
google-services = { id = "com.google.gms.google-services", version.ref = "googleServices" }
// build.gradle.kts в корена — декларира се, без да се прилага
alias(libs.plugins.google.services) apply false
// app/build.gradle.kts — тук вече се прилага и се добавят двете зависимости
plugins {
…
alias(libs.plugins.google.services)
}
…
implementation(platform(libs.firebase.bom))
implementation(libs.firebase.auth)
Пет неща за проверка, докато четете:
- Версиите са тези на поредицата: 4.6.0 и 35.2.0, които показва документацията на Firebase към 18 ноември 2026 г. Ако се появи друга, поискайте да я поправи: поредицата е изпробвана с тези.
- Има двата реда, BoM и
implementation(libs.firebase.auth). BoM само избира съвместими версии; вторият ред е този, който добавя Authentication. Със BoM и друга библиотека на Firebase на нейно мястоverificaдава 17 от 18 и казва „Falta Authentication“ (липсва Authentication) (измерено на 18 ноември 2026 г.). firebase-authне носи версия. Дава я BoM. Отделна версия там отменя онова, което BoM решава.- Тирето в каталога става точка:
google-servicesв каталога се пишеlibs.plugins.google.servicesвъв файла на Gradle. - Никой не е пипал вашия файл, нито е копирал стойностите му.
git statusне бива да показваgoogle-services.json(игнориран е) и никой.ktне бива да се появява променен.
- Пуснете
verifica. Сега редът еResultado: 18 de 18 pruebas en verde (0 en rojo, 0 con error, 0 saltadas)(резултат: 18 от 18 теста зелени, 0 червени, 0 с грешка, 0 пропуснати). Остава един червен знак, този наrespuestas/03.md: попълва се в стъпка 5. - Обяснете, в три реда на
respuestas/03.md: какво прави приставката с вашия файл и в кой момент.
Погледнете сами (по желание). Приставката оставя генерираното в values.xml под app/build/generated/res/.
Точната папка е вътрешна подробност и може да се променя от версия на версия, така че я потърсете, вместо да я
зазубрите. От inicio/:
find app/build/generated/res -name values.xml | xargs grep -l google_app_id
С версиите на поредицата отговори app/build/generated/res/processDebugGoogleServices/values/values.xml
(18 ноември 2026 г.). Отворете го и потърсете project_id, google_app_id и default_web_client_id. С пълния
измислен файл носеше шест имена: default_web_client_id,
google_api_key, google_app_id, google_crash_reporting_api_key, google_storage_bucket и project_id. С
файла без OAuth клиенти default_web_client_id не се появява. Това е данната, която бутонът за Google ще поиска в
урок 04, и е причината за сцената: без уеб клиент във файла приложението се компилира и без нея.
Какво доказва всеки знак и какво не.
- „Simulado“, тези за вашия файл: прочетоха текста на
app/google-services.json. Доказват какво носи. - „Simulado“, този за компилираното приложение: прочете ресурсите, които приставката е генерирала, както би ги прочело приложението. Доказва, че вашият файл е стигнал до приложението в тази компилация.
- „Simulado“, този за библиотеката: тестът помоли Firebase да стартира с тези ресурси и прочете с кой проект е останал. В инсталираното приложение, според документацията на Firebase, това стартиране го прави библиотеката при отварянето на приложението.
- „Simulado“, този за Authentication: попита дали главният клас на
firebase-authпътува в приложението. Не го използва: не създаде никаква сесия. - „Texto“ и „Git“: потърсиха думи във файловете ви и попитаха git какво следи.
Никой не е говорил с Firebase. Добре оформен файл от проект, който вече сте изтрили, минава зелено, а така минава и файл, сглобен на ръка с тази форма. Че файлът идва от вашия проект, че отпечатъкът е регистриран и че Google е включен, се проверява по единствения възможен начин: като влезете, в урок 04.
В инсталираното приложение. ./gradlew installDebug и го отворете: трябва да се види приветствието, както в урок
02. В емулатора от изпробването (Pixel 9, Android 37, 18 ноември 2026 г.), с решението и измислен файл, приложението
се отвори на „La tienda“ (екранът „Магазинът“) с бутона „Entrar“ („Вход“), а системният дневник (adb logcat) показа
реда FirebaseInitProvider: FirebaseApp initialization successful. Там бутоните не бяха натискани: пътят го мерят
симулираните тестове.
Ако някой ред още не ви е ясен, преди да продължите опитайте да го обясните със свои думи. Ако все още не се получава, върнете се към този откъс или поискайте разяснение.
Какво доказва и докъде. На симулираното ниво 18 от 18 доказва, че този файл има формата и данните, които урокът очаква, че са стигнали до тази компилация и че Authentication пътува в приложението. Не доказва, че файлът идва от вашия проект, че сте следвали реда, нито че Google е включен. Тази част от цел 3.1 се доказва на реалното ниво, когато влезете със своя акаунт в урок 04.
Стъпка 5 · Без ИИ: счупете едно нарочно
Това е упражнение 3.4 и се прави без Claude Code. Ще предизвикате грешката „конфигурацията е за друг пакет“, без да пипате файла си или конзолата: като промените отличителната данна от страната на приложението.
1. Предвидете. В app/build.gradle.kts ще смените applicationId = "mx.habil.ejemplo.tienda" с
applicationId = "mx.habil.ejemplo.otra". Напишете: компилира ли се? Кой се оплаква: Kotlin, Gradle или Firebase?
2. Счупете го и измерете. Направете промяната и компилирайте:
./gradlew assembleDebug
Ето какво даде на 18 ноември 2026 г. (пътят, съкратен):
* What went wrong:
Execution failed for task ':app:processDebugGoogleServices' …
> No matching client found for package name 'mx.habil.ejemplo.otra' in …/app/google-services.json
Копирайте в respuestas/03.md реда, който започва с > No matching client found.
3. Диагностицирайте, със свои думи, преди да прочетете следващото: какво е търсил, къде е търсил и защо не го е намерил?
Името на задачата го казва: processDebugGoogleServices е приставката, при компилиране. Тя е търсила в списъка
client на вашия файл приложение, чийто package_name да е applicationId на това, и такова няма. Мрежата и Firebase
не са участвали: грешката е излязла от сравняването на два текста на вашия компютър.
4. Поправката, която изкушава, и защо не. Ако редактирате на ръка package_name във файла, грешката при
компилиране изчезва. Не го правете: файлът е копие на онова, което е в конзолата, а конзолата продължава да има
регистрирано другото приложение. Правилното е двете отличителни данни наистина да съвпадат: или приложението ползва
регистрирания пакет, или регистрирате друго приложение с новия пакет и изтегляте неговия файл.
5. Поправете го. Върнете реда на applicationId = "mx.habil.ejemplo.tienda". Тази команда трябва да показва само
промените от стъпка 4 (само гледа):
git diff -- app/build.gradle.kts
Пуснете verifica: 18 от 18 и вече и знакът на respuestas/03.md.
Това зелено потвърждава две неща: че проектът е поправен и че сте поставили реда с грешката. Не знае дали сте го счупили, нито чете предвиждането ви, нито оценява диагнозата ви. Упражнение 3.4 се оценява с вашето обяснение и е завършено, когато можете да отметнете и трите:
- Предвиждането ви от точка 1 е написано, с онова, което сте видели под него.
- Поставили сте реда с грешката.
- Казали сте кой се оплака, кои два текста е сравнил и защо ръчното редактиране на файла не е поправката.
Доказва се с: „Счупете едно нарочно“ (цел 3.4).
Вашите упражнения
Стъпки 1 и 2, 3.3 и 3.4 се правят без изкуствен интелект.
| # | Правите | Готово е, когато |
|---|---|---|
| 3.1 | Следвате реда: проект → приложение → отпечатък → Google → изтегляне | verifica дава 18 от 18 с вашия файл: това валидира файла и компилацията. Че проектът е ваш, с регистриран отпечатък и включен Google, го валидира реалният вход в урок 04 |
| 3.2 | Обяснявате защо google-services.json не се качва в тази поредица и назовавате какво никога не се качва |
Обяснението ви е в respuestas/03.md. verifica проверява само .gitignore, .example и какво следи git |
| 3.3 | Различавате отпечатъка за отстраняване на грешки от този на публикувана версия | Отговорили сте на трите случая по-долу |
| 3.4 | Чупите пакета и диагностицирате грешката | Доказателството ви са трите квадратчета от стъпка 5, написани от вас. verifica само потвърждава, че проектът е поправен и че сте поставили грешката |
| 3.5 | Проверявате, без да отваряте конзолата, че файлът ви носи клиента с вашия отпечатък и уеб клиента | Знаците „Simulado“ за вашия файл са зелени. Отпечатъкът, който сравняват, е този за отстраняване на грешки на този компютър |
Упражнение 3.3 · Кой отпечатък регистрирате? Този, който регистрирахте днес, е за отстраняване на грешки на вашия компютър. Според документацията на Android и на Google едно приложение има повече от един:
| Кой подписва приложението | Откъде идва отпечатъкът му |
|---|---|
| Вашият компютър, когато компилира за проба | От keystore за отстраняване на грешки: ./gradlew signingReport, вариант debug |
| Вие, със собствен ключ, за да публикувате | От keystore на този ключ. Не е това за отстраняване на грешки |
| Google Play, с Play App Signing | От Play Console, на страницата за подписване на приложението. Ключът го пази Google и не е този, с който вие качвате приложението |
Отговорете в respuestas/03.md кой отпечатък трябва да се регистрира във Firebase във всеки случай:
- Вашата колежка клонира проекта ви и иска да влезе с Google от своя компютър, срещу вашия Firebase.
- Публикувате приложението в Google Play с Play App Signing и потребителите го изтеглят оттам.
- Сменяте компютъра и продължавате да разработвате.
Време: отделете около три часа, с конзолата на Firebase и „Счупете едно нарочно“. Това е оценка: ще я уточним според времето, което отнеме на първата група.
Не ви ли тръгва?
Съобщенията на английски са тези, които даде приставката google-services 4.6.0 на 18 ноември 2026 г.
| Виждате | Вероятна причина | Какво правите |
|---|---|---|
File google-services.json is missing. |
Приставката вече е приложена, а файлът не е в app/ |
Сложете го в inicio/app/, с точно това име. Върху solucion/ това се очаква в чисто копие (клонинг) на хранилището |
| ❌ „Falta Authentication“ (липсва Authentication) | Има BoM, а липсва библиотеката | Добавете implementation(libs.firebase.auth) в app/build.gradle.kts |
| ℹ️ „Hay uno en …/app/src/debug/…“ (има един в …/app/src/debug/…) | Файлът е в папка на вариант | Преместете го в app/: тази поредица използва само едно място |
No matching client found for package name '…' |
applicationId на приложението и пакетът на файла не съвпадат |
Стъпка 5. Ако файлът е за друг пакет, регистрирайте приложението с пакета на поредицата и изтеглете неговия файл |
| ❌ „no trae un cliente de OAuth de Android (tipo 1)“ (не носи OAuth клиент за Android (тип 1)) | Изтеглили сте го преди да регистрирате отпечатъка или да включите Google | Изтеглете го отново (стъпка 3, точка 5) |
| ❌ „Ningún cliente de Android de tu archivo trae la huella de depuración de esta computadora“ (никой клиент за Android във вашия файл не носи отпечатъка за отстраняване на грешки на този компютър) | Регистрирали сте друг отпечатък или файлът е изтеглен на друг компютър | Пуснете ./gradlew signingReport, регистрирайте този SHA1 и изтеглете отново |
| ❌ „no trae un cliente de OAuth web (tipo 3)“ (не носи уеб OAuth клиент (тип 3)) | Изтеглили сте го преди да включите Google | Включете Google и изтеглете отново |
| ❌ „Git sí rastrea un google-services.json“ (Git следи google-services.json) | Добавен е преди да съществува .gitignore |
git rm --cached <файл> го изважда от git, без да изтрива вашето копие |
keytool -list -v завършва с MissingFormatArgumentException |
Случи се на Mac на поредицата с Java 25 и системата на испански (18 ноември 2026 г.) | Използвайте ./gradlew signingReport, което е онова, което урокът иска |
~/.android/debug.keystore не съществува и нямате отпечатъка |
Още не сте компилирали нищо на този компютър: keystore го създава първата компилация за отстраняване на грешки, а не signingReport (измерено на Linux Mint 22.3, 18 ноември 2026 г.) |
Пуснете ./gradlew assembleDebug и после ./gradlew signingReport |
На Linux Mint 22.3 (x86_64) verifica на този урок излезе същото като на Mac (18 ноември 2026 г.): върху inicio/, 11
от 18 зелени; върху solucion/ без вашия файл, „0 pruebas corridas“ (0 изпълнени теста) със съобщението; а с
пробен файл, който носеше отпечатъка на този компютър, 18 от 18. Зависимостите на Firebase добавиха около 200 MB към
~/.gradle.
В заключение
Отговорете, без да четете отново:
- Кои са двете отличителни данни, по които Firebase разпознава вашето приложение, и къде е всяка на вашия компютър?
- Защо файлът се изтегля накрая, а не когато помощникът го предлага?
- Вашият
verificaдава 18 от 18. Кажете едно нещо, което това доказва, и едно, което не доказва. - Защо
google-services.jsonне се качва в тази поредица? И какво никога не се качва, в никоя?
Какво следва: в урок 04 поставяте бутона и влизате с Google. Там се проверява, наистина, всичко, което днес остана записано във вашия файл.
Сравнете отговорите си
Стъпка 1. Не ѝ излиза същият. Keystore за отстраняване на грешки го създават инструментите в личната папка на всекиго, така че всеки компютър има свой сертификат и свой отпечатък. Проектът е същият; подписът не е.
Стъпка 3. При изпробването на 13 ноември 2026 г. нито един от двата: файлът, изтеглен преди отпечатъка и преди
включването на Google, не носеше нито тип 1 (Android, с certificate_hash), нито тип 3 (уеб). Това е наблюдение от
онзи ден. Онова, което документацията на Firebase наистина твърди, е обратното: обновеният файл, изтеглен след
тези две стъпки, носи OAuth информацията, от която бутонът се нуждае. Затова се изтегля накрая.
Стъпка 4. Променят се три файла: gradle/libs.versions.toml, build.gradle.kts в корена и
app/build.gradle.kts. Никой .kt: свързването на приложението не е пипнало никой екран и затова седемте теста от
урок 02 остават зелени. Приставката чете app/google-services.json при компилиране и генерира ресурси на приложението
(project_id, google_app_id и, ако файлът носи уеб клиент, default_web_client_id). Приставката не се изпълнява в
телефона: онова, което работи при изпълнение, са библиотеките, които сте декларирали, като firebase-auth.
Стъпка 5. Не се компилира. Оплаква се Gradle, в задачата на приставката google-services; нито Kotlin, нито
Firebase. Сравнил е applicationId на приложението с package_name във файла. Редактирането на файла премахва
грешката и оставя конзолата с регистрирано друго приложение: отличителните данни пак няма да съвпадат там, където е
важно.
Упражнение 3.3.
- Тази за отстраняване на грешки на нейния компютър, добавена към вашето приложение във Firebase: едно приложение приема няколко отпечатъка. След това ѝ трябва файлът, изтеглен отново.
- Тази на сертификата, с който Google Play подписва приложението и която се проверява в Play Console. Тази за отстраняване на грешки и тази на ключа, с който качвате приложението, не вършат работа за онова, което изтеглят потребителите.
- Тази за отстраняване на грешки на новия компютър: това е друг keystore и друг отпечатък.
В заключение:
- Името на пакета, в
applicationIdнаapp/build.gradle.kts, и отпечатъкът на сертификата, с който се подписва приложението; този за отстраняване на грешки идва от keystore в личната ви папка и го отпечатваsigningReport. - Защото файлът е копие на онова, което конзолата знае в този момент, а Firebase съветва да се изтегли обновеният след отпечатъка и след включването на Google. При изпробването предишният не носеше OAuth клиентите.
- Доказва, че текстът на файла ви носи пакета, клиента за Android с вашия отпечатък за отстраняване на грешки и уеб клиента, че компилираното приложение носи тези данни и че Authentication пътува в приложението. Не доказва, че файлът идва от вашия проект, че проектът съществува, нито че можете да влезете с Google.
- Защото всеки има собствен проект, а не защото е тайна. Никога не се качват ключовете за подписване, паролите и тайният ключ на Microsoft.
Източници на урока
Отворени на 18 ноември 2026 г.
- Firebase. Add Firebase to your Android project (стъпки, пакетът не може да се променя, приставка 4.6.0 и BoM 35.2.0, „unique, but non-secret identifiers“). https://firebase.google.com/docs/android/setup
- Firebase. Google services Gradle plugin and JSON config file (какви ресурси генерира приставката и от кое поле идва всеки; съобщенията за грешки). https://firebase.google.com/docs/android/google-services-plugin-and-file
- Firebase. Understand Firebase for Android (какво е BoM; приставката работи при компилиране). https://firebase.google.com/docs/android/learn-more
- Firebase. Learn about and manage API keys for Firebase (ключовете идентифицират, не упълномощават). https://firebase.google.com/docs/projects/api-keys
- Firebase. Authenticate with Google on Android (отпечатък, включване на Google и изтегляне на обновения файл). https://firebase.google.com/docs/auth/android/google-signin
- Firebase. FirebaseInitProvider („Initializes Firebase APIs at app startup time“). https://firebase.google.com/docs/reference/android/com/google/firebase/provider/FirebaseInitProvider
- Помощ на Firebase. Download Firebase config file or object и Add a SHA fingerprint. https://support.google.com/firebase/answer/7015592 · https://support.google.com/firebase/answer/9137403
- Google for Developers. Client authentication (
./gradlew signingReport, хранилище за отстраняване на грешки, Play App Signing). https://developers.google.com/android/guides/client-auth - Android Developers. Sign your app (сертификат за отстраняване на грешки, ключове, отпечатъци за доставчици, Play App Signing). https://developer.android.com/studio/publish/app-signing
- Android Developers. Configure the app module (
applicationIdи „името на пакета“). https://developer.android.com/build/configure-app-module - Android Developers. Migrate your build to version catalogs (
libs.versions.toml,alias). https://developer.android.com/build/migrate-to-catalogs - Maven хранилището на Google: индексите му изброяват
google-services4.6.0 иfirebase-bom35.2.0. https://dl.google.com/dl/android/maven2/com/google/gms/google-services/maven-metadata.xml · https://dl.google.com/dl/android/maven2/com/google/firebase/firebase-bom/maven-metadata.xml - Изпробване на поредицата, 13 ноември 2026 г., Mac с Apple silicon: редът на стъпките в конзолата и онова, което се видя в онзи ден (помощникът не поиска отпечатъка; включването на Google поиска публично име и имейл за поддръжка; файлът, изтеглен твърде рано, не носеше OAuth клиенти; безплатен план). Имената на менютата и бутоните в този урок не идват от изпробването: те са тези на цитираната по-горе документация.
- Собствено измерване: Mac с Apple silicon, 18 ноември 2026 г. (
signingReport;verificaвърхуinicio/иsolucion/; измислените файлове: пълен, без клиенти, за друг пакет и с друг отпечатък; ресурсите, които генерира приставката; съобщенията за грешки;keytool; приложението, инсталирано в нов емулатор, без акаунт, който беше изтрит накрая). Измерванията бяха направени с измислени файлове, а не с реален проект във Firebase.
Външен преглед (18 ноември 2026 г.): С ПРОМЕНИ, 2 с висок приоритет, 6 със среден и 3 с нисък; приложен.
Предпочитате имейл? Пишете ни на hola@habil.mx