Tworzenie aplikacji Objective-C lub Swift dla systemu macOS

Artykuł
03/17/2024

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Chociaż możesz nadal używać programu Visual Studio App Center do momentu jego pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

Aby rozpocząć tworzenie pierwszej aplikacji dla komputerów Mac, wykonaj następujące kroki:

Połącz się z kontem usługi repozytorium (GitHub, Bitbucket, VSTS, Azure DevOps).
Wybierz repozytorium i gałąź, w której znajduje się aplikacja.
Skonfiguruj projekt lub obszar roboczy kompilacji oraz schemat, który chcesz skompilować.

Uwaga

Aby aplikacja została dystrybuowana, kompilacja musi być podpisana przy użyciu certyfikatu. Profil aprowizacji jest opcjonalny. Ponadto kompilacja dla instalatorów komputerów Mac nie jest obecnie obsługiwana.

1. Łączenie repozytorium

Musisz nawiązać połączenie z kontem usługi repozytorium. Po nawiązaniu połączenia z kontem wybierz repozytorium, w którym znajduje się projekt mac. Aby skonfigurować kompilację dla repozytorium, musisz mieć uprawnienia administratora i ściągania.

2. Wybieranie gałęzi

Po wybraniu repozytorium wybierz gałąź, którą chcesz skompilować. Domyślnie zostaną wyświetlone wszystkie aktywne gałęzie.

3. Konfigurowanie pierwszej kompilacji

Przed pierwszą kompilacją należy skonfigurować projekt dla komputerów Mac.

3.1. Projekt/obszar roboczy i schemat

W przypadku konfiguracji kompilacji wymagany jest projekt Xcode lub obszar roboczy Xcode oraz schemat udostępniony. Usługa App Center automatycznie wykrywa projekty, obszary robocze i schematy udostępnione w gałęzi. Wybierz projekt lub obszar roboczy, który chcesz skompilować, i odpowiadający mu schemat.

Jeśli nie można odnaleźć schematu, upewnij się, że schemat, za pomocą którego chcesz skompilować, jest udostępniony, a kontener schematu to projekt lub wybrany obszar roboczy. Upewnij się również, że te zmiany zostały zaewidencjonowane w gałęzi, dla której konfigurujesz kompilację.

3.2. Wersja programu Xcode

Wybierz wersję programu Xcode, aby uruchomić kompilację.

3.3. Wyzwalacze kompilacji

Domyślnie nowa kompilacja jest wyzwalana za każdym razem, gdy deweloper wypycha do skonfigurowanej gałęzi. Jest to nazywane "ciągłą integracją". Jeśli wolisz ręcznie wyzwolić nową kompilację, możesz zmienić to ustawienie w konfiguracji kompilacji.

3.4. Numer kompilacji przyrostowej

Po włączeniu w CFBundleVersion pliku Info.plist aplikacji automatycznie zwiększa się dla każdej kompilacji. Zmiana jest wykonywana przed kompilacją i nie zostanie zatwierdzona w repozytorium.

3.5. Testy

Jeśli wybrany schemat zawiera akcję testową z wybranym docelowym testem, możesz skonfigurować testy do uruchamiania w ramach każdej kompilacji. Usługa App Center może obecnie uruchamiać testy jednostkowe XCTest. Usługa App Center nie obsługuje testów uruchamiania kompilacji dla komputerów Mac.

3.6. Podpisywanie kodu

Pomyślna kompilacja spowoduje utworzenie .app pliku. Aby zainstalować kompilację na urządzeniu, musi być podpisany certyfikat. Aby podpisać kompilacje utworzone z gałęzi, włącz podpisywanie kodu w okienku konfiguracji i przekaż prawidłowy certyfikat (p12) wraz z hasłem certyfikatu. Ustawienia w projekcie Xcode muszą być zgodne z przekazywanymi plikami. Profil aprowizacji jest opcjonalny do podpisywania kodu.

Obecnie usługa App Center obsługuje tylko te konfiguracje podpisywania:

Ręczne podpisywanie przy użyciu metody eksportowania programowania tylko z certyfikatem dewelopera
Ręczne podpisywanie przy użyciu metody eksportowania identyfikatora dewelopera
Automatyczne podpisywanie przy użyciu metody eksportowania programowania

Więcej informacji na temat podpisywania kodu w przewodniku podpisywania kodu systemu macOS w usłudze App Center można przeczytać w oficjalnym przewodniku dla deweloperów firmy Apple.

3.7. CocoaPods

Usługa App Center skanuje wybraną gałąź i jeśli znajdzie plik Podfile, automatycznie wykona pod install krok na początku każdej kompilacji. Gwarantuje to, że wszystkie zależności są zainstalowane.

Jeśli repozytorium zawiera już folder /Pods , usługa App Center zakłada, że zaewidencjonujesz zasobniki w repozytorium i nie będzie już działać pod install.

3.8. Dystrybuowanie do grupy dystrybucyjnej

Można skonfigurować każdą pomyślnie podpisaną kompilację z gałęzi, która ma być dystrybuowana do wcześniej utworzonej grupy dystrybucyjnej. Nową grupę dystrybucyjną można dodać z sekcji Dystrybucja. Zawsze istnieje domyślna grupa dystrybucyjna o nazwie "Współpracownicy", która obejmuje wszystkich użytkowników, którzy mają dostęp do aplikacji.

Po zapisaniu konfiguracji zostanie automatycznie uruchomiona nowa kompilacja.

4. Wyniki kompilacji

Po wyzwoleniu kompilacji może ona znajdować się w następujących stanach:

queued — kompilacja jest w kolejce, czekając na zwolnienie zasobów.
building — kompilacja uruchamia wstępnie zdefiniowane zadania.
succeeded — kompilacja została ukończona pomyślnie.
failed — znaleziono błędy kompilacji, które uniemożliwiły ukończenie. Możesz rozwiązać problemy z kompilacją, pobierając i sprawdzając dzienniki kompilacji.
anulowano — kompilacja została anulowana przez akcję użytkownika lub upłynął limit czasu.

4.1. Dzienniki kompilacji

W przypadku ukończonej kompilacji (zakończonej powodzeniem lub niepowodzeniem) pobierz dzienniki, aby dowiedzieć się więcej na temat sposobu działania kompilacji. Usługa App Center udostępnia archiwum z następującymi plikami:

|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
    |-- <build-step-1> (e.g. 2_Get Sources.txt)
    |-- <build-step-2> (e.g. 3_Pod install.txt)
    |--
    |-- <build-step-n> (e.g. n_Post Job Cleanup.txt)

Dzienniki specyficzne dla kroków kompilacji (znajdujące się w build katalogu archiwum) są przydatne do rozwiązywania problemów i zrozumienia, w jakim kroku i dlaczego kompilacja nie powiodła się.

4.2. Aplikacja (.app)

Plik .app jest plikiem archiwum aplikacji dla komputerów Mac, który zawiera aplikację dla komputerów Mac.

Jeśli kompilacja jest poprawnie podpisana, .app plik można zainstalować na urządzeniu odpowiadającym profilowi aprowizacji używanemu podczas podpisywania. Więcej szczegółowych informacji na temat podpisywania i dystrybucji kodu za pomocą usługi App Center można znaleźć w dokumentacji podpisywania kodu systemu macOS w usłudze App Center.
Jeśli kompilacja nie została podpisana, .app plik może zostać podpisany przez dewelopera. Na przykład przy użyciu codesign.

4.3. Plik symboli (.dsym)

Pliki .dsym zawierają symbole debugowania dla aplikacji.

Jeśli zestaw SDK centrum aplikacji został dodany do aplikacji z włączonym modułem raportowania awarii, usługa raportowania awarii wymaga tego .dsym pliku dla kompilacji do wyświetlania raportów awarii możliwych do odczytania przez człowieka (symboliczne).
Jeśli dodano inny zestaw SDK do raportowania awarii w aplikacji, taki jak zestaw SDK usługi HockeyApp, usługa wymaga .dsym pliku do wyświetlania raportów o awarii możliwych do odczytania przez człowieka.

Pliki .dsym nie zmieniają się podczas podpisywania kodu ..app Jeśli zdecydujesz się na podpisanie kodu kompilacji później, .dsym wygenerowany przed podpisaniem kodu będzie nadal prawidłowy.

Kompilowanie wewnętrznych

Aby skompilować projekt, użyjemy xcodebuildnarzędzia wiersza polecenia, które umożliwia tworzenie, wykonywanie zapytań, analizowanie, testowanie i archiwizowanie projektów i obszarów roboczych programu Xcode.

Obsługiwane wersje i wymagania

Szczegóły wersji maszyny kompilacji są aktualizowane za każdym razem, gdy jest dodawana nowa wersja systemu macOS. Uwzględniamy najnowsze wersje wydane przez firmę Apple tak szybko, jak to możliwe, na naszych maszynach wirtualnych kompilacji.

Share via