Publikowanie aplikacji systemu iOS na potrzeby dystrybucji ad hoc
Dystrybucja ad hoc jest używana głównie do testowania aplikacji w szerokiej grupie osób i jest dostępna dla programu Apple Developer Program i programu Apple Developer Enterprise Program. Innym przypadkiem użycia dystrybucji ad hoc jest dystrybucja w firmie, gdy program App Store Connect nie jest opcją.
Dystrybucja ad hoc ma zaletę braku konieczności zatwierdzania ze sklepu App Store z aplikacjami instalowanymi przy użyciu programu Apple Configurator. Jednak w przypadku programowania i dystrybucji jest ograniczona do 100 urządzeń na rok członkostwa, a urządzenia muszą zostać dodane do konta dewelopera firmy Apple.
Dystrybucja aplikacji systemu iOS wymaga aprowizacji aplikacji przy użyciu profilu aprowizacji. Profile aprowizacji to pliki zawierające informacje o podpisywaniu kodu, a także tożsamość aplikacji i jej zamierzony mechanizm dystrybucji.
Aby dystrybuować aplikację systemu iOS dla wielu platform platformy .NET (.NET MAUI), należy utworzyć profil aprowizacji dystrybucji specyficzny dla niego. Ten profil umożliwia cyfrowe podpisanie aplikacji na potrzeby wydania, aby można było ją zainstalować na urządzeniu z systemem iOS. Profil aprowizacji dystrybucji ad hoc zawiera identyfikator aplikacji, certyfikat dystrybucji i listę urządzeń, które mogą zainstalować aplikację. Na potrzeby testowania możesz użyć tego samego identyfikatora aplikacji, który został użyty podczas wdrażania aplikacji na urządzeniu. Należy jednak utworzyć certyfikat dystrybucji, aby zidentyfikować siebie lub organizację, jeśli jeszcze go nie masz.
Proces tworzenia profilu aprowizacji dystrybucji ad hoc jest następujący:
- Utwórz certyfikat dystrybucji. Aby uzyskać więcej informacji, zobacz Tworzenie certyfikatu dystrybucji.
- Dodaj urządzenia do konta dewelopera firmy Apple. Aby uzyskać więcej informacji, zobacz Dodawanie urządzenia.
- Utwórz identyfikator aplikacji. Aby uzyskać więcej informacji, zobacz Tworzenie identyfikatora aplikacji.
- Utwórz profil aprowizacji. Aby uzyskać więcej informacji, zobacz Tworzenie profilu aprowizacji.
Tworzenie certyfikatu dystrybucji
Certyfikat dystrybucji służy do potwierdzania tożsamości. Przed utworzeniem certyfikatu dystrybucji upewnij się, że konto dewelopera firmy Apple zostało dodane do programu Visual Studio. Aby uzyskać więcej informacji, zobacz Zarządzanie kontami firmy Apple.
Jeśli jeszcze go nie masz, musisz utworzyć certyfikat dystrybucji. Certyfikat dystrybucji należy utworzyć przy użyciu identyfikatora Apple ID dla konta dewelopera firmy Apple.
Aby utworzyć certyfikat dystrybucji w programie Visual Studio:
- W programie Visual Studio przejdź do pozycji Narzędzia > Opcje > konta Xamarin > Apple.
- W oknie dialogowym Konta deweloperów firmy Apple wybierz zespół i kliknij przycisk Wyświetl szczegóły...
- W oknie dialogowym Szczegóły kliknij pozycję Utwórz certyfikat i wybierz pozycję Dystrybucja systemu iOS. Zostanie utworzona nowa tożsamość podpisywania i zsynchronizuje się z firmą Apple, pod warunkiem, że masz odpowiednie uprawnienia.
Ważne
Klucz prywatny i certyfikat, który składają się na tożsamość podpisywania, również zostaną wyeksportowane do programu Keychain Access na hoście kompilacji na komputerze Mac, pod warunkiem, że środowisko IDE jest sparowane z nim. Aby uzyskać więcej informacji, zobacz Pair to Mac for iOS development (Parowanie do komputerów Mac na potrzeby programowania w systemie iOS).
Opis par kluczy certyfikatu
Profil dystrybucji zawiera certyfikaty, skojarzone z nimi klucze i wszystkie profile aprowizacji skojarzone z kontem dewelopera firmy Apple. Istnieją dwie wersje profilu dystrybucji — jedna istnieje na koncie dewelopera firmy Apple, a druga na komputerze lokalnym. Różnica między nimi to typ kluczy, które zawierają: profil na koncie dewelopera firmy Apple zawiera wszystkie klucze publiczne skojarzone z certyfikatami, podczas gdy kopia na komputerze lokalnym zawiera wszystkie klucze prywatne. Aby certyfikaty są prawidłowe, pary kluczy muszą być zgodne.
Ostrzeżenie
Utrata certyfikatu i skojarzonych kluczy może być niezwykle destrukcyjna, ponieważ będzie wymagać cofnięcia istniejących certyfikatów i ponownego utworzenia profilów aprowizacji.
Tworzenie profilu dystrybucji
Profil aprowizacji dystrybucji ad hoc umożliwia aplikacji .NET MAUI dla systemu iOS podpisywane cyfrowo na potrzeby wydania, dzięki czemu można ją zainstalować na określonych urządzeniach z systemem iOS. Profil aprowizacji dystrybucji ad hoc zawiera identyfikator aplikacji, certyfikat dystrybucji i listę urządzeń, które mogą zainstalować aplikację. Urządzenia, które chcesz obsługiwać, muszą mieć wersję systemu iOS obsługiwaną przez program Xcode.
Dodawanie urządzenia
Podczas tworzenia profilu aprowizacji profil musi zawierać urządzenia, na których można uruchomić aplikację. Przed wybraniem urządzenia do dodania do profilu aprowizacji należy najpierw dodać urządzenie do konta dewelopera firmy Apple. Urządzenie można dodać, wykonując następujące czynności:
Podłącz urządzenie do aprowizowania lokalnego komputera Mac za pomocą USB.
Otwórz program Xcode i przejdź do pozycji Urządzenia okien > i symulatory.
W programie Xcode wybierz kartę Urządzenia i wybierz urządzenie z listy połączonych urządzeń.
W programie Xcode skopiuj wartość Identyfikator do schowka:
W przeglądarce internetowej przejdź do sekcji Urządzenia konta dewelopera firmy Apple i kliknij + przycisk.
Na stronie Rejestrowanie nowego urządzenia ustaw poprawną platformę i podaj nazwę nowego urządzenia. Następnie wklej identyfikator ze schowka do pola Identyfikator urządzenia (UDID), a następnie kliknij przycisk Kontynuuj:
Na stronie Rejestrowanie nowego urządzenia przejrzyj informacje, a następnie kliknij pozycję Zarejestruj.
Powtórz poprzednie kroki dla dowolnego urządzenia z systemem iOS, na którym chcesz wdrożyć aplikację .NET MAUI dla systemu iOS.
Tworzenie identyfikatora aplikacji
Identyfikator aplikacji jest wymagany do zidentyfikowania dystrybuowanych aplikacji. Identyfikator aplikacji jest podobny do ciągu odwrotnego DNS, który jednoznacznie identyfikuje aplikację i powinien być identyczny z identyfikatorem pakietu aplikacji. Na potrzeby testowania możesz użyć tego samego identyfikatora aplikacji, który został użyty podczas wdrażania aplikacji na urządzeniu.
Istnieją dwa typy identyfikatorów aplikacji:
- Symbol wieloznaczny. Identyfikator aplikacji z symbolami wieloznacznymi umożliwia używanie jednego identyfikatora aplikacji do dopasowania wielu aplikacji i zazwyczaj ma postać
com.domainname.*. Identyfikator aplikacji z symbolami wieloznacznymi może służyć do dystrybucji wielu aplikacji i powinien być używany w przypadku aplikacji, które nie umożliwiają obsługi funkcji specyficznych dla aplikacji. - Wyraźny. Jawny identyfikator aplikacji jest unikatowy dla pojedynczej aplikacji i zazwyczaj ma postać
com.domainname.myid. Jawny identyfikator aplikacji umożliwia dystrybucję jednej aplikacji z pasującym identyfikatorem pakietu. Jawne identyfikatory aplikacji są zwykle używane w przypadku aplikacji, które umożliwiają korzystanie z funkcji specyficznych dla aplikacji, takich jak Apple Pay lub Game Center. Aby uzyskać więcej informacji na temat możliwości, zobacz Możliwości.
Aby utworzyć nowy identyfikator aplikacji:
Na koncie dewelopera firmy Apple przejdź do pozycji Certyfikaty, identyfikatory i profile.
Na stronie Certyfikaty, Identyfikatory i profile wybierz kartę Identyfikatory .
Na stronie Identyfikatory kliknij + przycisk , aby utworzyć nowy identyfikator aplikacji.
Na stronie Rejestrowanie nowego identyfikatora wybierz przycisk radiowy Identyfikatory aplikacji przed kliknięciem przycisku Kontynuuj:
Na stronie Rejestrowanie nowego identyfikatora wybierz pozycję Aplikacja przed kliknięciem przycisku Kontynuuj:
Na stronie Rejestrowanie identyfikatora aplikacji wprowadź opis i wybierz przycisk radiowy Jawny lub Wieloznaczny identyfikator pakietu. Następnie wprowadź identyfikator pakietu dla aplikacji w odwrotnym formacie DS:
Ważne
Wprowadzony identyfikator pakietu musi odpowiadać identyfikatorowi pakietu w pliku Info.plist w projekcie aplikacji.
Identyfikator pakietu dla aplikacji MAUI platformy .NET jest przechowywany w pliku projektu jako właściwość Identyfikator aplikacji. W programie Visual Studio w Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt aplikacji .NET MAUI i wybierz pozycję Właściwości. Następnie przejdź do karty Ogólne udostępnione > usługi MAUI. Pole Identyfikator aplikacji zawiera listę identyfikatora pakietu.
Po zaktualizowaniu wartości pola Identyfikator aplikacji wartość identyfikatora pakietu w pliku Info.plist zostanie automatycznie zaktualizowana.
Na stronie Rejestrowanie identyfikatora aplikacji wybierz wszystkie możliwości używane przez aplikację. Wszystkie możliwości należy skonfigurować zarówno na tej stronie, jak i w pliku Entitlements.plist w projekcie aplikacji. Aby uzyskać więcej informacji, zobacz Możliwości i uprawnienia.
Na stronie Rejestrowanie identyfikatora aplikacji kliknij przycisk Kontynuuj.
Na stronie Potwierdzanie identyfikatora aplikacji kliknij przycisk Zarejestruj.
Tworzenie profilu aprowizacji
Po utworzeniu identyfikatora aplikacji należy utworzyć profil aprowizacji dystrybucji. Ten profil umożliwia cyfrowe podpisanie aplikacji na potrzeby wydania, aby można było ją zainstalować na urządzeniu z systemem iOS.
Aby utworzyć profil aprowizacji dla dystrybucji ad hoc:
Na stronie Certyfikaty, identyfikatory i profile konta dewelopera firmy Apple wybierz kartę Profile .
Na karcie Profile kliknij + przycisk , aby utworzyć nowy profil.
Na stronie Rejestrowanie nowego profilu aprowizacji wybierz przycisk radiowy Ad Hoc przed kliknięciem przycisku Kontynuuj :
Na stronie Generowanie profilu aprowizacji na liście rozwijanej Identyfikator aplikacji wybierz utworzony wcześniej identyfikator aplikacji i wybierz, czy chcesz utworzyć profil offline, przed kliknięciem przycisku Kontynuuj :
Na stronie Generowanie profilu aprowizacji wybierz przycisk radiowy odpowiadający certyfikatowi dystrybucji przed kliknięciem przycisku Kontynuuj :
Na stronie Generowanie profilu aprowizacji wybierz urządzenia, na których zostanie zainstalowana aplikacja, a następnie kliknij przycisk Kontynuuj.
Na stronie Generowanie profilu aprowizacji wprowadź nazwę profilu aprowizacji przed kliknięciem przycisku Generuj:
Uwaga
Zanotuj nazwę profilu aprowizacji, ponieważ będzie ona wymagana podczas podpisywania aplikacji.
Na stronie Generowanie profilu aprowizacji opcjonalnie kliknij przycisk Pobierz, aby pobrać profil aprowizacji.
Uwaga
Teraz nie trzeba pobierać profilu aprowizacji. Zamiast tego zrobisz to w programie Visual Studio.
Pobieranie profilów aprowizacji w programie Visual Studio
Po utworzeniu profilu aprowizacji dystrybucji na koncie dewelopera firmy Apple program Visual Studio może go pobrać, aby był dostępny do podpisywania aplikacji:
- W programie Visual Studio przejdź do pozycji Narzędzia > Opcje > konta Xamarin > Apple.
- W oknie dialogowym Konta deweloperów firmy Apple wybierz swój zespół i kliknij pozycję Wyświetl szczegóły.
- W oknie dialogowym Szczegóły sprawdź, czy nowy profil jest wyświetlany na liście Profile aprowizacji. Aby odświeżyć listę, może być konieczne ponowne uruchomienie programu Visual Studio.
- W oknie dialogowym Szczegóły kliknij pozycję Pobierz wszystkie profile.
Profile aprowizacji są pobierane w systemie Windows i eksportowane do hosta kompilacji komputera Mac, jeśli środowisko IDE jest sparowane z nim. Aby uzyskać więcej informacji, zobacz Pair to Mac for iOS development (Parowanie do komputerów Mac na potrzeby programowania w systemie iOS).
Opublikuj aplikację
Program Visual Studio może opublikować aplikację .NET MAUI dla systemu iOS na potrzeby dystrybucji ad hoc:
W programie Visual Studio upewnij się, że środowisko IDE jest sparowane z hostem kompilacji dla komputerów Mac. Aby uzyskać więcej informacji, zobacz Pair to Mac for iOS development (Parowanie do komputerów Mac na potrzeby programowania w systemie iOS).
Na pasku narzędzi programu Visual Studio użyj listy rozwijanej Debuguj element docelowy, aby wybrać pozycję Urządzenia zdalne z systemem iOS, a następnie pozycję Urządzenie zdalne:
Na pasku narzędzi programu Visual Studio użyj listy rozwijanej Konfiguracja rozwiązań, aby zmienić konfigurację debugowania na konfigurację wydania:
W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt aplikacji .NET MAUI i wybierz pozycję Właściwości. Następnie przejdź do karty Podpisywanie pakietu dla systemu iOS i upewnij się, że opcja Schemat jest ustawiona na ręczne aprowizowanie, tożsamość podpisywania jest ustawiona na Wartość Dystrybucja (automatyczna), a profil aprowizacji jest ustawiony na Wartość Automatyczna:
Te ustawienia zapewnią, że program Visual Studio wybierze prawidłowy profil aprowizacji na podstawie identyfikatora pakietu w pliku Info.plist (który jest identyczny z wartością właściwości Identyfikator aplikacji w pliku projektu). Alternatywnie ustaw tożsamość podpisywania na odpowiedni certyfikat dystrybucji i profil aprowizacji na profil utworzony na koncie dewelopera firmy Apple.
W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt aplikacji .NET MAUI i wybierz pozycję Publikuj...:
Zostanie otwarty Menedżer archiwum, a program Visual Studio rozpocznie archiwizowanie pakietu aplikacji:
Proces archiwizowania podpisuje aplikację przy użyciu certyfikatu i profilów aprowizacji określonych na karcie Podpisywanie pakietu systemu iOS dla wybranej konfiguracji rozwiązania.
W Menedżerze archiwum po pomyślnym zakończeniu archiwizacji upewnij się, że archiwum jest zaznaczone, a następnie wybierz przycisk Rozpowszechnij ... , aby rozpocząć proces pakowania aplikacji do dystrybucji:
Zostanie wyświetlone okno dialogowe Dystrybucja — wybieranie kanału .
W oknie dialogowym Dystrybucja — wybieranie kanału wybierz przycisk Ad Hoc:
W oknie dialogowym Dystrybucja — tożsamość podpisywania wybierz swój profil podpisywania i aprowizacji:
Uwaga
Należy użyć profilu podpisywania i aprowizacji utworzonego dla aplikacji i wybranego kanału dystrybucji.
W oknie dialogowym Dystrybucja — tożsamość podpisywania wybierz przycisk Zapisz jako i wprowadź nazwę pliku. Aplikacja zostanie następnie ponownie podpisana i opublikowana w pliku ipa w systemie plików.
Następnie aplikację można rozpowszechniać przy użyciu programu Apple Configurator. Aby uzyskać więcej informacji, zobacz Podręcznik użytkownika programu Apple Configurator w witrynie support.apple.com.
Aby uzyskać informacje na temat publikowania aplikacji systemu iOS przy użyciu interfejsu wiersza polecenia, zobacz Publikowanie aplikacji systemu iOS przy użyciu wiersza polecenia.
