Към съдържанието
Съдържание на курса

Урок 06 — Два бутона, един акаунт

От · съосновател и Chief Executive Officer на Hábil ·

Преди да четете, три думи. По един ред за всяка.

  • Колизия: онова, което се случва, когато някой влезе с един доставчик, а имейлът му вече има потребител във вашия проект, създаден с друг доставчик. Видяхте я в урок 05.
  • Свързване (linking): добавяне на още един начин за влизане към потребител, който вече съществува. Не създава нов потребител.
  • Един акаунт на имейл адрес (One account per email address): опцията на вашия проект във Firebase, заради която възниква колизията.

Какво отнасяте: човек със същия имейл в Google и в Microsoft, който остава с един потребител във вашия магазин, до когото стига с който и да е от двата бутона, защото сам го е потвърдил.

Новата идея на този урок: един човек, два доставчика. С „един акаунт на имейл адрес“ вторият се свързва с акаунта, който вече съществува, и то само с потвърждението на човека. Останалото —екранът, който пита, вратата на свързването и бележката, която различава свързване от вход— идва готово и обяснено и тук не се оценява.

Бележка за текстовете на приложението. Както в предишните уроци, проектът носи екранните си текстове на испански, а verifica търси точно тези текстове. В блоковете с код, в изходите на терминала и в скиците на екрана те остават такива, каквито са в проекта; в прозата урокът ги дава на български и първия път поставя оригинала в скоби: потвърждението „Също и с Microsoft?“ (в проекта: „¿También con Microsoft?“) с бутоните „Свържете Microsoft“ (в проекта: „Enlazar Microsoft“) и „Не сега“ (в проекта: „Ahora no“).


Сцената

Ана влезе в магазина с Google миналата седмица. Днес докосва другия бутон. Акаунтът ѝ в Microsoft има същия имейл.

За нея това е същият човек, който влиза в същия магазин. За вашия проект това са две различни удостоверения, които твърдят, че имат един и същ имейл.

Това се провери при изпробването на тази поредица на 13 ноември 2026 г., с акаунт в Microsoft, с чийто имейл вече се беше влизало с Google. Firebase не го пусна и отговори: «An account already exists with the same email address but different sign-in credentials».

Има два лоши края. При единия приложението създава втори потребител и поръчките на Ана остават разпределени между два акаунта, които не се познават. При другия приложението слива двата акаунта от своя страна, без да пита никого. Урок 05 спря дотам, че ѝ казва „влезте с другия бутон“. Този пише добрия край: влиза с онзи, който вече е имала, приложението я пита и, ако приеме, двата бутона стигат до едно и също място.


Преди да започнете

Какво ви трябва: завършеният урок 05 (неговият verifica на 44 от 44). Стъпки от 1 до 4 не изискват никакъв акаунт в Microsoft. Стъпка 5 изисква: вашата регистрация в Entra от урок 05, която работи.

Началният проект. От корена на хранилището на поредицата:

git pull
cp lecciones/03-la-app-conoce-a-firebase/inicio/app/google-services.json lecciones/06-dos-botones-una-cuenta/inicio/app/
cd lecciones/06-dos-botones-una-cuenta/inicio

Тръгва от решението на урок 05, със скелето на този урок отгоре. ./verifica solucion излиза червено в чисто копие (клонинг) на хранилището, защото без вашия файл проектът не се компилира. Отговорите ви отиват в respuestas/06.md.

Правило, което остава в сила от урок 05. Никога не поставяйте и не качвайте стойността на ключа от Entra, токен за достъп или за самоличност, нито снимки на екрана или дневници, които ги носят. Резултатът от едно свързване също носи токен за достъп: това приложение не го чете. google-services.json остава игнориран, защото е от вашия проект: не го използвайте за доказателство. Ако ключ или токен е докоснал файл, терминала или снимка на екрана, той се отменя и се създава друг.

Какво не прави този урок. Не премахва свързване, не запазва сесията и не я затваря (урок 07) и не различава първия път (урок 08).


Стъпка 1 · В конзолата: правилото, което кара колизията да съществува

Сблъсъкът на този урок —ERROR_ACCOUNT_EXISTS_WITH_DIFFERENT_CREDENTIAL при влизане с втория доставчик— се появява само с една опция на вашия проект във Firebase: „един акаунт на имейл адрес“ (One account per email address). Референцията на Firebase казва, че тази грешка се хвърля само с включена опция, и я препоръчва. С няколко акаунта на имейл Firebase може да създаде втори потребител: първият лош край от сцената и нищо за разрешаване. Същото изключение има и други кодове, например при свързване на акаунт, който вече е на друг потребител: те не са случаят на този урок и приложението ги показва като грешка.

Потърсете я в настройките на Authentication във вашата конзола и проверете дали е включена. Запишете в respuestas/06.md този ред, без имейли и без ключове:

una cuenta por correo: activa

(На български: един акаунт на имейл адрес: включена.)

verifica не вижда вашата конзола: само търси този ред. Точния път до тази опция в конзолата не го обходихме с акаунт; ако не я намерите, разкажете ни къде е била.

Доказва се с: вашата проверка, на ръка. Част е от доказателството на 6.1.


Стъпка 2 · Какво вече носи проектът

Редът го налага Firebase. Неговото ръководство за свързване на акаунти иска първо човекът да влезе с който и да е доставчик и после, към този потребител, който вече е влязъл, да се добави другият. Така, казва, човекът има същия потребителски идентификатор, независимо с кой влиза. За Microsoft ръководството на този доставчик назовава повикването: startActivityForLinkWithProvider, върху потребителя, който вече е влязъл.

Три файла са нови и четири са се променили спрямо решението на урок 05. Отворете ги; не ги редактирайте:

Файл Какво носи
Enlace.kt (нов) ResultadoDeEnlace (свързан, без сесия, отказан, грешка), EnlaceRetomado и интерфейсът Enlace, с enlazar() и retomar()
PuertaDelEnlace.kt (нов) Вратата EnlazadorDeProveedor. enlazar прави повикването на Firebase; ако никой не е влязъл, хвърля NadieHaEntrado, без да отваря нищо. pendiente поема свързване, останало наполовина
PantallaEnlace.kt (нов) Потвърждението: «¿También con Microsoft?» (Също и с Microsoft?), с «Enlazar Microsoft» (Свържете Microsoft) и «Ahora no» (Не сега)
Tienda.kt Помни дали е имало колизия. Когато този човек влезе после с правилния бутон, показва потвърждението вместо началния екран. Само «Enlazar Microsoft» вика вашия код
PuertaDelNavegador.kt Един ред: не взема висящото, ако онова, което е останало наполовина, е било свързване
MainActivity.kt, Armado.kt Сглобяват и свързването. Засега Armado.kt връща EnlaceSinConectar()

Останалото е идентично с решението на урок 05, а verifica го сравнява файл по файл. Това е ограничение на тази дейност, а не на целта: промяна във файл, който е даден, може да е валиден код и пак да излезе в червено, защото урокът ги фиксира, за да може да каже какво измерва.

Свързване, останало наполовина, не е вход, останал наполовина. Референцията на Firebase казва, че ако екранът умре по време на свързване, неговият край се поема с getPendingAuthResult: същото място, откъдето идва вход, останал наполовина. Онова, което следва, е решение на това приложение, а не цитат: този резултат не носи етикет, който тук да се използва, за да се знае дали е било свързване или вход. Прочетен винаги като вход, отказано свързване би се видяло като „не успяхте да влезете“. Затова вратата записва една бележка в телефона, преди да отвори браузъра за свързване: „има свързване в ход“. Това е да или не; не пази акаунти, токени или ключове. При отварянето на приложението вратата за влизане не взема висящото, ако тази бележка е поставена, а Tienda пита първо вашето свързване.

Измерете изходната точка. От корена на хранилището:

./lecciones/06-dos-botones-una-cuenta/verifica

На 18 ноември 2026 г., с измислен файл, последният ред беше Resultado: 46 de 66 pruebas en verde (20 en rojo, 0 con error, 0 saltadas). Общо са 66: 44-те, които наследявате от урок 05, вече зелени, и 22 на свързването. От тях две вече минават със скелето, а двайсет чакат вашия код.

(Резултат: 46 от 66 теста са зелени, 20 червени, 0 с грешка, 0 пропуснати.)


Стъпка 3 · С Claude Code: свързване и поемане

Влиза както винаги: предвиждате → искате → четете какво е генерирал → пускате verifica → обяснявате.

  1. Предвидете, в respuestas/06.md: в момента на колизията, преди човекът да е влязъл с Google, към кой потребител би могло да се свърже Microsoft?
  2. Поискайте от Claude Code, стоейки в inicio/: „В EnlaceConMicrosoft.kt вземи EntradaConMicrosoft.kt за образец. enlazar() сглобява същия доставчик, вика enlazador.enlazar и връща ResultadoDeEnlace.Enlazado. retomar() вика enlazador.pendiente(): ако върне null, връща null; ако не, връща EnlaceRetomado с неговото име и с Enlazado, ако неговото falla е null, или с преведената грешка. Грешките се превеждат в отделна функция: NadieHaEntrado е SinSesion; FirebaseAuthWebException с ERROR_WEB_CONTEXT_CANCELED, Cancelado; всяка друга, Fallo. CancellationException се оставя да мине. В Armado.kt смени само тялото на armarEnlaceConMicrosoft и изтрий там EnlaceSinConectar. Не променяй никой друг файл.“
  3. Прочетете. Центърът трябва да прилича на това:
override suspend fun enlazar(): ResultadoDeEnlace =
    try {
        val proveedor = OAuthProvider.newBuilder("microsoft.com")
            .addCustomParameter("prompt", "select_account")
            .build()
        enlazador.enlazar(proveedor)
        ResultadoDeEnlace.Enlazado
    } catch (e: CancellationException) {
        throw e
    } catch (e: Exception) {
        resultadoDe(e)
    }

override suspend fun retomar(): EnlaceRetomado? {
    val pendiente = enlazador.pendiente()
    if (pendiente == null) return null
    val resultado = if (pendiente.falla == null) ResultadoDeEnlace.Enlazado else resultadoDe(pendiente.falla)
    return EnlaceRetomado(pendiente.nombre, resultado)
}

private fun resultadoDe(falla: Exception): ResultadoDeEnlace = when {
    falla is NadieHaEntrado -> ResultadoDeEnlace.SinSesion
    falla is FirebaseAuthWebException && falla.errorCode == "ERROR_WEB_CONTEXT_CANCELED" ->
        ResultadoDeEnlace.Cancelado
    else -> ResultadoDeEnlace.Fallo
}

Проверете три неща: че enlazar() вика вратата на свързването и не влиза отново; че retomar() не отговаря винаги „свързано“; и че никой не е пипал тестовете, вратите или екраните.

  1. Пуснете verifica. 66-те теста може да останат зелени. Предаването още не е пълно: липсват отметките „Escrito“ на respuestas/06.md и истинското ниво от стъпка 5. verifica го казва накрая, в „Estado del objetivo 6.1“ (състояние на цел 6.1).
  2. Обяснете, в три реда: защо свързването се прави върху потребителя, който вече е влязъл, а не при колизията.

Какво доказва и докъде. verifica използва фиктивен проект (ProyectoFalso.kt) с двама души: Ана, със същия имейл в Google и в Microsoft, и Луис, с друг имейл. Доказва, че преди свързването Ана се сблъсква и не се създава втори потребител; че след свързването двата ѝ достъпа стигат до един и същ потребител; и че Луис си остава друг. Доказва потвърждението, с вашите класове, начертани в Tienda: при колизията не се предлага свързване, след влизането се пита, без да се свързва нищо, а «Ahora no» (Не сега) не свързва. И доказва, че свързване, останало наполовина, се поема като свързване: приложението се отваря на потвърждението, с «Listo» (Готово) или със своето съобщение.

Саботажите бяха измерени върху решението на 18 ноември 2026 г.: да не се разпознае NadieHaEntrado, 63 от 66; retomar(), което винаги връща null, 60; такова, което винаги отговаря „свързано“, 63; четенето на свързването, останало наполовина, като вход, 64.

Три ограничения. „Същият потребител“ е този на фиктивния проект, който следва „един акаунт на имейл адрес“, написан на ръка: не доказва, че Firebase свързва вашите акаунти. „Остана наполовина“ го каза дубльор: никой тест не е затварял приложението по средата на свързване, а бележката в телефона е упражнена само без нищо висящо. И че вратата за влизане спазва тази бележка, никой тест не го вижда (без този ред 66-те дават зелено): подкрепя го това, че файлът е идентичен в inicio/ и в solucion/.


Стъпка 4 · Без ИИ: ами ако приложението свържеше само?

Това е упражнение 6.2 и се прави без Claude Code. Потвърждението е критерий на тази поредица: свързването дава на друг акаунт достъп до този потребител, а това го решава човекът, който току-що се е удостоверил с доставчика на акаунта, който вече съществува. Тук го проверявате, като го махнете.

1. Предвидете, в respuestas/06.md: ако приложението свързваше веднага щом човекът влезе, без да пита, какво би видяла Ана? И какво би могло да се случи, ако акаунтът в Microsoft, който се е сблъскал, не беше неин?

2. Счупете го и измерете. В Tienda.kt, вътре в recibe, сменете този ред:

pantalla = if (huboColision && enlace != null) Pantalla.CONFIRMAR_ENLACE else Pantalla.INICIO

с тези два:

if (huboColision && enlace != null) alcance.launch { enlace.enlazar() }
pantalla = Pantalla.INICIO

Пуснете verifica. Ето какво даде на 18 ноември 2026 г. (съкратено):

❌ Restricción de esta actividad (no del objetivo): estos archivos vienen dados y ya no son iguales … Tienda.kt
❌ La confirmación: 2 de 4 pruebas en verde. Nada se enlaza sin el toque de la persona, y solo se le ofrece …
❌ Al tocar «Enlazar Microsoft» no se enlaza, o después Microsoft no llega al mismo usuario (paso 3)
Resultado: 63 de 66 pruebas en verde (3 en rojo, 0 con error, 0 saltadas), leído de …

(Това е изходът на verifica, на испански. На български, в червено: ограничение на тази дейност (не на целта): тези файлове идват дадени и вече не са еднакви, Tienda.kt; потвърждението: 2 от 4 теста са зелени, нищо не се свързва без докосването на човека и само му се предлага…; при докосване на „Enlazar Microsoft“ не се свързва, или после Microsoft не стига до същия потребител (стъпка 3). Резултат: 63 от 66 теста са зелени.)

Копирайте в respuestas/06.md реда, който казва „La confirmación“ (потвърждението).

3. Поправете го. Върнете оригиналния ред. Пуснете verifica: 66 от 66, и Tienda.kt пак е същият като този на урока.

4. Обяснете, без да четете отново: защо приложението иска потвърждение, преди да свърже, и какво би станало, ако свързваше само. Сравнете със „Сравнете отговорите си“.

Доказва се с: вашето обяснение (цел 6.2). verifica само търси поставения ред: не знае дали сте го счупили, нито оценява онова, което сте написали. Предлагането на свързване преди влизането, в самата колизия, беше измерено отделно: 62 от 66.


Стъпка 5 · В телефона: ръчният тест

Това е истинското доказателство на 6.1 и още не може да се завърши с тези инструкции. Онова, което следва, казва какво да се наблюдава и какво остава да се измери. Изисква истинското ниво от урок 05, с работеща ваша регистрация в Entra, и включена опция „един акаунт на имейл адрес“ (стъпка 1).

Обиколката. С акаунт в Microsoft, чийто имейл вече е влизал с Google: докоснете „Entrar con Microsoft“ („Вход с Microsoft“) и прочетете съобщението; влезте с Google; приемете „Enlazar Microsoft“. Според ръководството на Firebase, след свързване човекът може да влиза с който и да е от свързаните доставчици и да стига до същите данни.

Онова, което липсва: излизането. За да проверите бутона на Microsoft, трябва да влезете отново от нулата, а това приложение още няма как да затвори сесията: това е урок 07. Предложението за изпробването, без да се изпреварва код, е да се изтрият данните на приложението в телефона:

adb shell pm clear mx.habil.ejemplo.tienda

Документацията на adb казва, че тази команда изтрива всички данни, свързани с едно приложение. С истински акаунт още не сме проверили три неща: че приложението остава без сесия, че потребителят и неговите доставчици си остават във Firebase и че докосването на „Entrar con Microsoft“ стига до същия потребител. Не измерихме и къде конзолата показва двата доставчика, нито затворихме процеса по средата на свързване с adb shell am kill (което не затваря сесията: това е друг тест). Ако го изпробвате, разкажете ни какво сте видели.

Вашият запис. Когато го направите, запишете в respuestas/06.md, без имейли и токени:

Какво записвате Пример
Датата, на ред, който започва така prueba manual: 2026-11-30
Преди свързването един потребител, с Google
След свързването същият потребител, с Google и Microsoft

verifica чете само първия ред и дори с него казва, че не е видял теста.

При изпробването на 13 ноември 2026 г., с пробен код, който имаше как да излезе, се видя краткият път: вече влязъл с Google, се свърза Microsoft, същият потребител остана с двата доставчика, а след излизане и влизане с Microsoft се стигна до него.

Доказва се с: това е единственото, което доказва, че Firebase е свързал вашите акаунти. 66 от 66 не го замества.


Вашите упражнения

Стъпка 4 се прави без ИИ.

# Правите Готово е, когато
6.1 Разрешавате колизията: човекът влиза с доставчика, който вече е имал, и свързва другия, с потвърждение Три доказателства, и трите са нужни. Редът „una cuenta por correo: activa“ в respuestas/06.md, след като го проверите във вашата конзола. Симулирано: „Estado del objetivo 6.1“ казва, че симулираното ниво е завършено, с фиктивен проект от двама души; валидира реда, потвърждението, свързването, останало наполовина, и че двата достъпа стигат до един и същ потребител дубльор. Реално: ръчният тест от стъпка 5, с вашата регистрация записана; това е единственото, което валидира, че Firebase е свързал вашите акаунти, и още не сме го пускали с истински акаунт
6.2 Обяснявате защо приложението иска потвърждение, преди да свърже, и какво би станало, ако свързваше само Предвиждането ви, червеното, което сте поставили, и обяснението ви са в respuestas/06.md и съвпадат със „Сравнете отговорите си“. Обяснението го сравнявате вие

Време: отделете час и половина без ръчния тест и още половин час с него. Това е оценка: ще я уточним според времето, което отнеме на първата група.


Не ви ли тръгва?

Виждате Вероятна причина Какво правите
File google-services.json is missing. Не сте копирали файла си в inicio/app/ cp от „Преди да започнете“
❌ „Restricción de esta actividad… lo heredado ya no es idéntico a la solución de la lección 05“ (ограничение на тази дейност… наследеното вече не е идентично с решението на урок 05) Променено е нещо наследено git diff -- <файл> и върнете го на ръка
❌ „Restricción de esta actividad… ya no son iguales en inicio/ y en solucion/“ (ограничение на тази дейност… вече не са еднакви в inicio/ и в solucion/) с Tienda.kt Идвате от стъпка 4 Върнете оригиналния ред
❌ „Enlazar sin haber entrado primero“ (да се свърже, без да е влязъл първо) Вашата resultadoDe не разпознава NadieHaEntrado Стъпка 3
❌ „Retomar el enlace“ (поемане на свързването) retomar() не използва онова, което връща enlazador.pendiente(), или отговаря винаги едно и също Стъпка 3
Влязохте с Microsoft с имейл, който вече е влизал с Google, и не излезе съобщението за колизията Вашият проект позволява няколко акаунта на имейл: Firebase е създал друг потребител Стъпка 1. Не свързвайте двама потребители, създадени поотделно, сякаш е случаят от урока
„Primero entra con el botón que ya usabas…“ (първо влезте с бутона, който вече използвахте…) Поискано е свързване, без никой да е влязъл Влезте първо; свързването е върху потребител, който вече е влязъл
❌ „EnlaceConMicrosoft.kt nombra una puerta concreta“ (EnlaceConMicrosoft.kt назовава конкретна врата) Вашият код назовава истинската врата (EnlazadorConFirebase) или дубльор от тестовете. Тестовете му подават само дубльори: ако кодът ви пита коя му се е паднала, зеленото не казва какво прави с истинската Кодът ви да говори само с EnlazadorDeProveedor. Истинската врата я избира MainActivity.kt, който е даден (стъпка 3)

На Linux Mint 22.3 (x86_64) verifica на този урок излезе същото като на Mac (18 ноември 2026 г.), на симулираното ниво и с пробен файл, който носеше отпечатъка на този компютър: върху inicio/, 46 от 66 зелени; върху solucion/, 66 от 66.


В заключение

Отговорете, без да четете отново:

  1. Коя опция на вашия проект кара сблъсъка на този урок да се появи и какво става без нея?
  2. Защо първо се влиза и после се свързва?
  3. Вашият verifica дава 66 от 66 и „симулирано ниво: завършено“. Кажете едно нещо, което това доказва, и едно, което не доказва.
  4. Защо свързване, останало наполовина, не може да се чете като вход, останал наполовина?

Какво следва: в урок 07 сесията остава: приложението ви разпознава, когато се върнете, и научавате как да я затворите.


Сравнете отговорите си

Стъпка 3. Към никой: при колизията никой не е влязъл, така че няма потребител, към когото да се добави нещо. Затова редът е първо вход и после свързване, и затова вратата хвърля NadieHaEntrado.

Стъпка 4. Ана нямаше да види нищо: щеше да влезе в началния екран и, отзад, щеше да ѝ се отвори браузърът за свързване, без да го е поискала. А ако акаунтът в Microsoft, който се е сблъскал, беше на друг човек с достъп до този имейл, този акаунт щеше да остане с достъп до потребителя на Ана, без тя да го е решила. Потвърждението оставя решението на човека, който току-що се е удостоверил с доставчика на акаунта, който вече съществува. Това доказва, че е влязъл с този доставчик; не доказва нищо друго за това кой е.

В заключение:

  1. „Един акаунт на имейл адрес“. Без нея Firebase може да създаде втори потребител със същия имейл и сблъсъкът на този урок не се появява.
  2. Защото свързването е добавяне на доставчик към потребител, който вече е влязъл: преди влизането няма към кого.
  3. Доказва какво иска вашето свързване и какво отговаря, че нищо не се свързва без докосването на човека и че, в фиктивен проект, двата достъпа стигат до един и същ потребител. Не доказва, че Firebase свързва вашите акаунти.
  4. Защото Firebase ги предава от същото място и не казва кое е било. Прочетено като вход, отказано свързване би се видяло като „не успяхте да влезете“.

Източници на урока

Отворени на 18 ноември 2026 г.

  • Firebase. Link Multiple Auth Providers to an Account on Android (първо се влиза и после се свързва; същият идентификатор с който и да е доставчик; след свързване може да се влиза с всеки. Примерът му използва linkWithCredential; за Microsoft ръководството на този доставчик посочва startActivityForLinkWithProvider). https://firebase.google.com/docs/auth/android/account-linking
  • Firebase. Authenticate Using Microsoft on Android (свързване на Microsoft към потребител, който вече е влязъл). https://firebase.google.com/docs/auth/android/microsoft-oauth
  • Firebase. Authenticate Using Microsoft with JavaScript (случаят Microsoft и Google с „един акаунт на имейл адрес“: влизане с доставчика, който вече съществува, и свързване на другия). https://firebase.google.com/docs/auth/web/microsoft-oauth
  • Firebase. Референция на FirebaseUser (startActivityForLinkWithProvider и неговият висящ резултат). https://firebase.google.com/docs/reference/android/com/google/firebase/auth/FirebaseUser
  • Android Developers. Android Debug Bridge (pm clear: изтрива всички данни, свързани с едно приложение; am kill). https://developer.android.com/tools/adb
  • Firebase. Референция на FirebaseAuth (getPendingAuthResult). https://firebase.google.com/docs/reference/android/com/google/firebase/auth/FirebaseAuth
  • Firebase. Референция на FirebaseAuthUserCollisionException (ERROR_ACCOUNT_EXISTS_WITH_DIFFERENT_CREDENTIAL само с „един акаунт на имейл адрес“, която препоръчва). https://firebase.google.com/docs/reference/android/com/google/firebase/auth/FirebaseAuthUserCollisionException
  • Изпробване на поредицата, 13 ноември 2026 г., Mac с Apple silicon, с пробен код: колизията с истински акаунт и свързването след влизане с Google.
  • Собствено измерване: Mac с Apple silicon, 18 ноември 2026 г. verifica върху inicio/ и solucion/, всяка стъпка и всяко счупване, с измислени файлове и без да се докосва конзолата на Firebase, тази на Entra, нито някакъв акаунт.
Да обсъдим вашия проект

Предпочитате имейл? Пишете ни на hola@habil.mx