Rejestrowanie dodatkowych urządzeń z iOS

Jeśli chcesz rozpowszechniać kompilacje ad hoc na iOS za pomocą App Distribution, musisz zarejestrować urządzenia testerów zgodnie z tym przewodnikiem. Kompilacja ad hoc to kompilacja, która nie jest podpisana profilem firmowym. Urządzenie może zainstalować kompilację ad hoc tylko wtedy, gdy jego unikalny identyfikator urządzenia (UDID) jest uwzględniony w profilu udostępniania kompilacji.

Gdy tester zaakceptuje zaproszenie do testowania aplikacji, App Distribution poprosi o zgodę na udostępnienie 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 zbierze z niego identyfikator UDID i powiadomi Cię o nim e-mailem.

Gdy otrzymasz e-maila z identyfikatorem UDID, zaktualizuj swój profil udostępniania o ten identyfikator i rozpowszechnij nową kompilację wśród testerów. Identyfikatory UDID możesz eksportować ręcznie za pomocą Firebasekonsoli lub interfejsu wiersza poleceń Firebase albo automatycznie za pomocą fastlane.

Ręczne eksportowanie identyfikatorów UDID

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

      Na karcie Testerzy i grupy na panelu App Distribution wybierz Wszyscy testerzy, a potem 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 Dystrybuowanie aplikacji na zarejestrowane urządzenia.

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

    • Opcja 2. Zbierz i wpisz identyfikatory UDID w e-mailu.

      Na stronie Dodaj urządzenia w portalu Apple Developer zarejestruj nowy identyfikator UDID podany w otrzymanym e-mailu.

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

Programowe eksportowanie identyfikatorów UDID za pomocą narzędzia fastlane

  1. Wyeksportuj wszystkie identyfikatory UDID urządzeń testerów jako plik CSV z fastlane. Na przykład utwórz i uruchom nową ścieżkę 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ń). Więcej informacji znajdziesz w dokumentacji Apple. Pamiętaj, że konto dewelopera Apple może umożliwiać importowanie tylko ograniczonej liczby urządzeń rocznie.

  3. Dodaj zarejestrowane urządzenia do profilu udostępniania.

  4. Pobierz profil udostępniania i użyj go do ponownego utworzenia aplikacji. Jeśli ponownie tworzysz aplikację 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 masz już rozpowszechnioną kompilację o tym samym numerze i wersji, e-maile z powiadomieniami otrzymają tylko użytkownicy nowo zarejestrowanych urządzeń.

Otrzymywanie alertów

Otrzymywanie domyślnych alertów

Domyślnie Firebase może wysyłać App Distribution alerty o nowych rejestracjach urządzeń z iOSApp Distribution e-mailem.

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

Domyślnie każdy członek 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 własnym 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, nadal musisz mieć wymagane uprawnienia.

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

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

Konfigurowanie zaawansowanych alertów w usługach innych firm

Możesz też wysyłać App Distribution alerty do preferowanego kanału powiadomień zespołu za pomocą Cloud Functions for Firebase. Możesz na przykład napisać funkcję, która rejestruje zdarzenie alertu dotyczące rejestracji nowego urządzenia z iOS i przesyła informacje o alercie do usługi innej firmy, takiej jak Discord, Slack lub 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 udostępniania aplikacji, ponownie ją kompiluje i rozpowszechnia z zaktualizowanym profilem udostępniania.

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

  1. Skonfiguruj Cloud Functions dla Firebase, wykonując te czynności:

    1. Skonfiguruj ś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 wdroż funkcję, która przechwytuje zdarzenie alertu z App Distribution i obsługuje ładunek zdarzenia (np. publikuje informacje o alercie w wiadomości na Discordzie).

Wszystkie zdarzenia alertów, które możesz rejestrować, znajdziesz w dokumentacji referencyjnej App Distributionalertów.

Dalsze kroki