Rozpowszechnianie aplikacji na iOS testerom przy użyciu fastlane

Kompilacje możesz rozpowszechniać wśród testerów za pomocą fastlane, czyli platformy open source, która automatyzuje tworzenie i publikowanie aplikacji na iOS i Androida. Postępuj zgodnie z prostymi instrukcjami opisanymi w dokumencie Fastfile. Po skonfigurowaniu pasa szybkiego ruchu i urządzenia Fastfile możesz zintegrować usługę App Distribution ze swoją konfiguracją szybkiego pasa.

Krok 1. Konfigurowanie fastlane

1. Zainstaluj i skonfiguruj fastlane.

2. Aby dodać App Distribution do konfiguracji fastlane, uruchom to polecenie w katalogu głównym projektu na iOS:

   fastlane add_plugin firebase_app_distribution

   Jeśli polecenie wyświetli opcję, wybierz Option 3: RubyGems.org.

Krok 2. Uwierzytelnienie za pomocą Firebase

Zanim użyjesz wtyczki fastlane, musisz najpierw uwierzytelnić się w projekcie Firebase na jeden z poniższych sposobów. Jeśli nie jest używana żadna inna metoda uwierzytelniania, domyślnie wtyczka typu fastlane szuka danych logowania w interfejsie wiersza poleceń Firebase.

Krok 3. Konfigurowanie Fastfile i rozpowszechnianie aplikacji

1. Na pasie ./fastlane/Fastfile dodaj blok firebase_app_distribution. Aby skonfigurować dystrybucję, użyj tych parametrów:

   Parametry firebase_app_distribution
   app	Wymagany tylko wtedy, gdy aplikacja nie zawiera pliku konfiguracji Firebase (GoogleService-Info.plist): identyfikator aplikacji Firebase Twojej aplikacji. Identyfikator aplikacji znajdziesz w konsoli Firebase na stronie ustawień ogólnych. app: "1:1234567890:ios:0a1b2c3d4e5f67890"
   googleservice_info_plist_path	Ścieżka do pliku GoogleService-Info.plist względem ścieżki zarchiwizowanego produktu. Domyślnie jest ono ustawione na GoogleService-Info.plist. Plik służy do uzyskiwania identyfikatora aplikacji Firebase, jeśli parametr app nie jest określony.
   firebase_cli_token	token odświeżania wydrukowany podczas uwierzytelniania środowiska CI za pomocą interfejsu wiersza poleceń Firebase (więcej informacji znajdziesz w artykule Używanie interfejsu wiersza poleceń w systemach CI).
   service_credentials_file	Ścieżka do pliku JSON konta usługi Google. Powyżej znajdziesz informacje o uwierzytelnianie z użyciem danych logowania konta usługi.
   ipa_path	Zastępuje ustawienie apk_path (wycofane). Ścieżka bezwzględna do pliku IPA, który chcesz przesłać. Jeśli nie określono inaczej, lokalizacja pliku będzie określana na podstawie pasa, na którym został wygenerowany.
   release_notes release_notes_file	Informacje o tej kompilacji. Możesz podać informacje o wersji bezpośrednio: release_notes: "Text of release notes" Możesz też podać ścieżkę do pliku tekstowego: release_notes_file: "/path/to/release-notes.txt"
   testers testers_file	Adresy e-mail testerów, których chcesz zaprosić. Testerów możesz podać w postaci listy oddzielonych przecinkami adresów e-mail: testers: "ali@example.com, bri@example.com, cal@example.com" Możesz też podać ścieżkę do pliku tekstowego zawierającego listę oddzielonych przecinkami adresów e-mail: testers_file: "/path/to/testers.txt"
   groups groups_file	Grupy testerów, które chcesz zaprosić (patrz Zarządzanie testerami). Grupy są określane za pomocą aliasów grup, które możesz sprawdzić w konsoli Firebase. Grupy możesz podać w postaci listy rozdzielanej przecinkami: groups: "qa-team, trusted-testers" Możesz też podać ścieżkę do pliku tekstowego zawierającego rozdzieloną przecinkami listę nazw grup: groups_file: "/path/to/groups.txt"
   test_devices test_devices_file	Poniższe typy dystrybucji są częścią funkcji automatycznych testerów w wersji beta. Urządzenia testowe, na które chcesz rozpowszechniać kompilacje (patrz Testy automatyczne). Możesz podać urządzenia testowe w postaci listy urządzeń testowych rozdzielonych średnikami: test_devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait" Możesz też podać ścieżkę do pliku tekstowego zawierającego listę urządzeń testowych rozdzielonych średnikami: test_devices_file: "/path/to/test-devices.txt"
   test_username	Nazwa użytkownika do automatycznego logowania, która ma być używana podczas testów zautomatyzowanych.
   test_password test_password_file	Hasło do automatycznego logowania używane podczas testów automatycznych. Możesz też określić ścieżkę do pliku tekstowego zawierającego hasło: test_password_file: "/path/to/test-password.txt"
   test_username_resource	Nazwa zasobu w polu nazwy użytkownika na potrzeby automatycznego logowania, które jest używane podczas testów automatycznych.
   test_password_resource	Nazwa zasobu w polu hasła na potrzeby automatycznego logowania się podczas testów automatycznych.
   test_non_blocking	asynchronicznie przeprowadzać testy automatyczne; Otwórz konsolę Firebase, aby wyświetlić wyniki automatycznych testów.
   debug	Flaga wartości logicznej. Aby wydrukować szczegółowe dane debugowania, ustaw wartość true.

Przykład:

platform :ios do
    desc "My awesome app"
    lane :distribute do
        build_ios_app(...)
        # build_ios_app is a built-in fastlane action.

        release = firebase_app_distribution(
            app: "1:123456789:ios:abcd1234",
            testers: "tester1@company.com, tester2@company.com",
            release_notes: "Lots of amazing new features to test out!"
        )

    end
end

Aby udostępnić kompilację testerom, wyznacz tę ścieżkę:

fastlane <lane>

Wartość zwrotna tego działania to hasz, który reprezentuje przesłaną wersję. Ten ciąg znaków jest też dostępny za pomocą funkcji lane_context[SharedValues::FIREBASE_APP_DISTRO_RELEASE]. Więcej informacji o dostępnych polach w tym haśle znajdziesz w dokumentacji interfejsu API REST.

Po przesłaniu wersji wtyczka fastlane wygeneruje te linki. Te linki pomogą Ci zarządzać plikami binarnymi i zadbać o to, aby testerzy i inni deweloperzy mieli odpowiednią wersję:

• Link do konsoli Firebase wyświetlającej pojedynczą wersję. Możesz udostępnić ten link innym programistom w Twojej organizacji.
• link do wersji w interfejsie testów (klipy internetowe na iOS), który umożliwia testerom wyświetlanie informacji o wersji i instalowanie aplikacji na urządzeniu; Aby użyć tego linku, tester musi mieć dostęp do wersji.
• Podpisany link, który umożliwia bezpośrednie pobranie i zainstalowanie binarnego pliku aplikacji (plik IPA). Link wygasa po godzinie.

Rozpowszechniona kompilacja będzie przez 150 dni dostępna w panelu App Distribution w konsoli Firebase. Gdy upłynie 30 dni od wygaśnięcia kompilacji, w konsoli i na liście kompilacji na urządzeniu testowym pojawi się odpowiednie powiadomienie.

Testerzy, którzy nie zostali wcześniej zaproszeni do testowania aplikacji, otrzymają e-maile z zaproszeniem do testowania. Dotychczasowi testerzy otrzymują e-maile z powiadomieniami, że nowa wersja jest gotowa do testowania. Więcej informacji o instalowaniu aplikacji testowej znajdziesz w artykule Konfigurowanie aplikacji jako tester. W konsoli Firebase możesz sprawdzać stan każdego testera, aby dowiedzieć się, czy zaakceptował on zaproszenie i czy pobrał aplikację.

(Opcjonalnie) Aby automatycznie zwiększać numer kompilacji za każdym razem, gdy tworzysz nową wersję w sekcji Dystrybucja aplikacji, możesz użyć akcji firebase_app_distribution_get_latest_release i akcji increment_build_number. Ten kod pokazuje, jak automatycznie zwiększać liczbę kompilacji:

lane :increment_version do
  latest_release = firebase_app_distribution_get_latest_release(
    app: "<your Firebase app ID>"
  )
  increment_build_number({ build_number: latest_release[:buildVersion].to_i + 1 })
end

Więcej informacji o tej funkcji wtyczki fastlane znajdziesz w artykule Uzyskiwanie informacji o najnowszej wersji aplikacji.

Krok 4 (opcjonalny). Zarządzanie testerami na potrzeby dystrybucji

Testerów możesz dodawać do projektu lub grupy i usuwać z niego za pomocą pliku Fastfile lub bezpośrednio uruchamiając działania szybkiej linii. Działania wykonywane bezpośrednio zastępują wartości ustawione w polu Fastfile.

Po dodaniu testera do projektu Firebase możesz dodać go do poszczególnych wersji. Testerzy usunięci z projektu Firebase nie mają już dostępu do wersji w tym projekcie, ale mogą zachować do nich dostęp przez pewien czas.

Jeśli masz dużą liczbę testerów, rozważ użycie grup.

Użyj konta Fastfile

# Use lanes to add or remove testers from a project.
lane(:add_testers) do
  firebase_app_distribution_add_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
    group_alias: "qa-team" # (Optional) add testers to this group
  )
end

lane(:remove_testers) do
  firebase_app_distribution_remove_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
    group_alias: "qa-team" # (Optional) remove testers from this group only
  )
end

# Add or remove testers with the terminal
$ fastlane add_testers
$ fastlane remove_testers

Wykonywanie działań fastlane

fastlane run firebase_app_distribution_create_group display_name:"QA Team" alias:"qa-team"
fastlane run firebase_app_distribution_add_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_remove_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_delete_group alias:"qa-team"

Możesz też zamiast --emails wskazać testerów --file="/path/to/testers.txt.

Zadania firebase_app_distribution_add_testers i firebase_app_distribution_remove_testers akceptują też te argumenty:

• project_name: numer projektu Firebase.
• group_alias (opcjonalnie): jeśli ta opcja jest zaznaczona, testerzy zostaną dodani do określonej grupy (lub z niej usunięci).
• service_credentials_file: ścieżka do pliku z danymi logowania do usługi Google.
• firebase_cli_token: token uwierzytelniania dla interfejsu wiersza poleceń Firebase.

Argumenty service_credentials_file i firebase_cli_token to te same argumenty, których używa działanie przesyłania.

Krok 5 (opcjonalny). Uzyskiwanie informacji o najnowszej wersji aplikacji

Możesz użyć działania firebase_app_distribution_get_latest_release, aby pobrać informacje o najnowszej wersji aplikacji w Narzędziu do dystrybucji aplikacji, w tym informacje o wersji aplikacji, informacje o wersji i czas utworzenia. Przykłady zastosowań obejmują automatyczne zwiększanie wersji i przenoszenie notatek z poprzedniej wersji.

Wartość zwracana przez działanie to hasz, który reprezentuje najnowszą wersję. Ten ciąg znaków jest też dostępny za pomocą funkcji lane_context[SharedValues::FIREBASE_APP_DISTRO_LATEST_RELEASE]. Więcej informacji o polach dostępnych w tym haszu znajdziesz w dokumentacji interfejsu API REST.

Parametry

app: "1:1234567890:ios:0a1b2c3d4e5f67890"

Dalsze kroki

• Aby zarejestrować więcej urządzeń ręcznie lub programowo, zapoznaj się z artykułem Rejestrowanie dodatkowych urządzeń z iOS.

• Poznaj sprawdzone metody rozpowszechniania aplikacji Apple wśród testerów QA za pomocą CI/CD i fastlane.