Rejestrowanie dodatkowych urządzeń z iOS

Jeśli chcesz rozpowszechniać kompilacje ad hoc na iOS za pomocą usługi App Distribution, musisz postępować zgodnie z tym przewodnikiem, aby zarejestrować urządzenia testerów. Kompilacja ad hoc to kompilacja, która nie jest podpisana profilem Enterprise. Kompilację ad hoc można zainstalować na urządzeniu tylko wtedy, gdy unikalny identyfikator urządzenia (UDID) jest uwzględniony w profilu obsługi administracyjnej kompilacji.

Gdy tester zaakceptuje zaproszenie do testowania aplikacji, App Distribution poprosi o zgodę na udostępnienie Tobie, deweloperowi, identyfikatora urządzenia testera. Przed pobraniem kompilacji ad hoc App Distribution prosi testera o zarejestrowanie urządzenia. Jeśli tester zarejestruje swoje urządzenie, App Distribution pobierze z niego identyfikator UDID i powiadomi Cię o nim e-mailem.

Gdy otrzymasz e-maila z identyfikatorem UDID, zaktualizuj profil obsługi administracyjnej, dodając do niego ten identyfikator, i udostępnij testerom nową kompilację. Możesz ręcznie wyeksportować identyfikatory UDID za pomocą konsoli Firebase lub interfejsu wiersza poleceń Firebase albo automatycznie za pomocą fastlane.

Ręczne eksportowanie identyfikatorów UDID

  1. Dodaj urządzenia do portalu dla programistów Apple.
    • Opcja 1. Zaimportuj identyfikatory UDID urządzeń jako plik CSV.

      Na karcie Testerzy i grupy w panelu App Distribution wybierz Wszyscy testerzy, a następnie kliknij Eksportuj identyfikatory UDID Apple, aby pobrać plik CSV. Następnie zaimportuj plik na konto dewelopera Apple, korzystając z opcji Register Multiple Devices (Zarejestruj wiele urządzeń). Więcej informacji znajdziesz w artykule Rozpowszechnianie aplikacji na zarejestrowanych urządzeniach.

      Pamiętaj, że Twoje konto dewelopera Apple może zezwalać na importowanie tylko ograniczonej liczby urządzeń rocznie.

    • Opcja 2. Zbierz i wpisz identyfikatory UDID za pomocą poczty e-mail.

      Na stronie Add Devices (Dodaj urządzenia) w portalu dla programistów Apple zarejestruj nowy identyfikator UDID podany w otrzymanym e-mailu.

  2. Dodaj zarejestrowane urządzenia do profilu obsługi administracyjnej.
  3. Pobierz profil obsługi administracyjnej i użyj go do ponownego utworzenia aplikacji. Jeśli robisz to tylko po to, aby zaktualizować zarejestrowane urządzenia, nie aktualizuj numeru kompilacji ani wersji.
  4. Ponownie rozpowszechnij aplikację za pomocą konsoli Firebase lub interfejsu wiersza poleceń. Jeśli nie zmienisz wersji, numeru kompilacji ani kodu aplikacji, App Distribution nie utworzy nowej wersji i nie powiadomi testerów. Jeśli kompilacja o tym samym numerze kompilacji i wersji została już rozpowszechniona, e-maile z powiadomieniami otrzymają tylko użytkownicy nowo zarejestrowanych urządzeń.

Programowe eksportowanie identyfikatorów UDID za pomocą fastlane

  1. Wyeksportuj wszystkie identyfikatory UDID urządzeń testerów jako plik CSV z fastlane. Możesz na przykład utworzyć i uruchomić nowy pas ruchu download_udids:

    lane :download_udids do
    firebase_app_distribution_get_udids(
        app: "<your Firebase app ID>",
        output_file: "<path to output file>",
    )
end

  2. Zaimportuj identyfikatory UDID na konto dewelopera Apple, korzystając z opcji Register Multiple Devices(Zarejestruj wiele urządzeń). Szczegółowe informacje znajdziesz w dokumentacji Apple. Pamiętaj, że konto dewelopera Apple może zezwalać na importowanie tylko ograniczonej liczby urządzeń rocznie.

  3. Dodaj zarejestrowane urządzenia do profilu obsługi administracyjnej {: .external}.

  4. Pobierz profil obsługi administracyjnej i użyj go do ponownego utworzenia aplikacji. Jeśli robisz to tylko w celu zaktualizowania zarejestrowanych urządzeń, nie aktualizuj numeru kompilacji ani wersji.

  5. Ponownie rozpowszechnij aplikację. Jeśli nie zmienisz wersji, numeru kompilacji ani kodu aplikacji, App Distribution nie utworzy nowej wersji i nie powiadomi testerów. Jeśli kompilacja o tym samym numerze kompilacji i wersji została już rozpowszechniona, e-maile z powiadomieniem otrzymają tylko użytkownicy nowo zarejestrowanych urządzeń.

Otrzymywanie alertów

Otrzymywanie alertów domyślnych

Domyślnie Firebase może wysyłać e-mailem App Distribution alertów dotyczących rejestracji nowych urządzeń z iOS.

Aby otrzymywać alerty App Distribution za pomocą tego domyślnego mechanizmu, musisz mieć uprawnienie firebase.projects.update. To uprawnienie jest domyślnie uwzględnione w tych rolach: Administrator Firebase, Właściciel projektu lub Edytujący projekt.

Domyślnie każdy użytkownik projektu (który ma wymagane uprawnienia do otrzymywania alertów) otrzyma e-maila, gdy zostanie zarejestrowane nowe urządzenie z iOS.

Włączanie i wyłączanie alertów na własnym koncie

Na swoim koncie możesz włączać i wyłączać alerty App Distribution bez wpływu na innych członków projektu. Pamiętaj, że aby otrzymywać alerty, musisz mieć wymagane uprawnienia.

Aby włączyć lub wyłączyć alerty App Distribution, wykonaj te czynności:

  1. W prawym górnym rogu konsoli Firebase kliknij Alerty Firebase.
  2. Następnie otwórz Ustawienia i ustaw ustawienia konta dotyczące alertów App Distribution.

Konfigurowanie zaawansowanych alertów dla usług innych firm

Możesz też wysyłać alerty App Distribution do preferowanego kanału powiadomień zespołu za pomocą Cloud Functions for Firebase. Możesz na przykład napisać funkcję, która przechwytuje zdarzenie alertu dotyczące rejestracji nowego urządzenia z iOS i publikuje informacje o alercie w usłudze innej firmy, takiej jak Discord, Slack czy Jira.

Aby w pełni zautomatyzować proces wprowadzania nowych testerów iOS, możesz napisać funkcję, która dodaje identyfikator UDID nowego urządzenia z iOS do profilu obsługi administracyjnej aplikacji, ponownie kompiluje aplikację i rozpowszechnia ją ze zaktualizowanym profilem obsługi administracyjnej.

Aby skonfigurować zaawansowane funkcje alertów za pomocą Cloud Functions for Firebase, wykonaj te czynności:

  1. Skonfiguruj Cloud Functions dla Firebase, co obejmuje te zadania:

    1. skonfigurować środowisko programistyczne dla Node.js lub Pythona,
    2. Zainstaluj interfejs wiersza poleceń Firebase i zaloguj się w nim.
    3. Zainicjuj Cloud Functions for Firebase za pomocą interfejsu wiersza poleceń Firebase.

  2. Napisz i wdróż funkcję, która przechwytuje zdarzenie alertu z App Distribution i obsługuje ładunek zdarzenia (np. publikuje informacje o alercie w wiadomości na Discordzie).

Aby dowiedzieć się więcej o wszystkich zdarzeniach alertów, które możesz przechwytywać, zapoznaj się z dokumentacją referencyjną dotyczącą alertów App Distribution.

Dalsze kroki