Pakiety systemu iOS

W przypadku systemu iOS narzędzie ADT konwertuje kod bajtowy pliku SWF i inne pliki źródłowe na natywną aplikację systemu iOS.

  1. Utwórz plik SWF przy użyciu programu Flash Builder lub Flash Professional albo kompilatora wiersza polecenia.

  2. Otwórz warstwę poleceń lub terminal i przejdź do folderu projektu aplikacji na telefon iPhone.

  3. Następnie utwórz plik IPA za pomocą narzędzia ADT, korzystając z poniższej składni.

    adt     -package 
                                        -target [ipa-test | ipa-debug | ipa-app-store | ipa-ad-hoc | 
                                        ipa-debug-interpreter | ipa-debug-interpreter-simulator 
                                        ipa-test-interpreter | ipa-test-interpreter-simulator] 
                                        -provisioning-profile PROFILE_PATH 
                                        SIGNING_OPTIONS 
                                        TARGET_IPA_FILE 
                                        APP_DESCRIPTOR 
                                        SOURCE_FILES 
                                        -extdir extension-directory 
                                        -platformsdk path-to-iossdk or path-to-ios-simulator-sdk

    Zmień odniesienie do aplikacji adt w celu uwzględnienia pełnej ścieżki do aplikacji adt. Aplikacja ADT zostanie zainstalowana w podkatalogu bin zestawu SDK środowiska AIR.

    Należy wybrać opcję -target odpowiadającą typowi aplikacji na telefon iPhone, którą chce się utworzyć:

    • -target ipa-test — tę opcję należy wybrać, aby szybko skompilować wersję aplikacji na potrzeby testowania na telefonie iPhone, którym dysponuje programista. Można też użyć opcji ipa-test-interpreter , która przyspiesza kompilację, lub opcji ipa-test-interpreter-simulator , która pozwala uruchomić symulator systemu iOS.

    • -target ipa-debug — tę opcję należy wybrać, aby skompilować wersję debugowanej aplikacji na potrzeby testowania na telefonie iPhone, którym dysponuje programista. Ta opcja umożliwia odbieranie wyników instrukcji trace() z aplikacji na telefon iPhone w sesji debugowania.

      Możliwe jest podanie jednej z następujących opcji -connect ( OPCJE_POŁĄCZENIA ) w celu określenia adresu IP komputera programistycznego, na którym działa debuger:

      • -connect — aplikacja będzie próbowała nawiązać (przez sieć Wi-Fi) połączenie z sesją debugowania na komputerze używanym do programowania, na którym została skompilowana.

      • -connect ADRES_IP — aplikacja będzie próbowała nawiązać połączenie (przez sieć Wi-Fi) z sesją debugowania na komputerze o określonym adresie IP. Przykład:

        -target ipa-debug -connect 192.0.32.10
      • -connect NAZWA_HOSTA — aplikacja będzie próbowała nawiązać połączenie (przez sieć Wi-Fi) z sesją debugowania na komputerze o określonej nazwie hosta. Na przykład:

        -target ipa-debug -connect bobroberts-mac.example.com

      Opcja -connect nie jest wymagana. Jeśli nie zostanie określona, uzyskana aplikacja przeznaczona do debugowania nie będzie próbowała łączyć się z debugerem na hoście. Można także użyć opcji ‑listen zamiast ‑connect , aby włączyć debugowanie przez połączenie USB opisane w rozdziale Zdalne debugowanie za pomocą programu FDB i połączenia USB .

      Jeśli próba połączenia z sesją debugowania nie powiedzie się, aplikacja wyświetli okno dialogowe z prośbą o wpisanie adresu IP komputera z debugerem. Próba połączenia nie powiedzie się, jeśli urządzenie nie jest podłączone do sieci Wi-Fi. Problem z połączeniem może również wystąpić, jeśli urządzenie jest podłączone, ale nie znajduje się za zaporą sieciową hosta z debugerem.

      Można też użyć opcji ipa-debug-interpreter , która przyspiesza kompilację, lub opcji ipa-debug-interpreter-simulator , która pozwala uruchomić symulator systemu iOS.

      Więcej informacji zawiera sekcja Debugowanie aplikacji AIR dla urządzeń przenośnych .

    • -target ipa-ad-hoc — tę opcję należy wybrać w celu utworzenia aplikacji na potrzeby instalacji ad hoc. Więcej informacji można znaleźć w witrynie Apple Dev Center firmy Apple.

    • -target ipa-app-store — tę opcję należy wybrać w celu utworzenia ostatecznej wersji pliku IPA z myślą o udostępnieniu w serwisie Apple App Store.

    Zastąp element PROFILE_PATH ścieżką do pliku profilu informacyjnego dla tworzonej aplikacji. Więcej informacji na temat profilów informacyjnych zawiera sekcja Konfiguracja w systemie iOS .

    Za pomocą opcji -platformsdk można wskazać zestaw SDK symulatora iOS w przypadku tworzenia aplikacji przeznaczonej do uruchamiania w symulatorze systemu iOS.

    Zastąp element SIGNING_OPTIONS odwołaniem do certyfikatu i hasła programisty aplikacji na telefon iPhone. Należy użyć poniższej składni:

    -storetype pkcs12 -keystore P12_FILE_PATH -storepass PASSWORD

    Zastąp element P12_FILE_PATH ścieżką do pliku certyfikatu P12. Zastąp element PASSWORD hasłem dla certyfikatu. (Patrz przykład poniżej.) Więcej informacji na temat pliku certyfikatu P12 zawiera sekcja Konwertowanie certyfikatu programisty na plik magazynu kluczy P12 .

    Uwaga: Podczas pakowania dla symulatora systemu iOS można użyć certyfikatu podpisanego automatycznie.

    Zastąp element APP_DESCRIPTOR odwołaniem do pliku deskryptora aplikacji.

    Zastąp element SOURCE_FILES odwołaniem do głównego pliku SWF projektu wraz z ewentualnymi innymi zasobami, które mają zostać uwzględnione. Uwzględnij ścieżki do wszystkich plików ikon zdefiniowanych w oknie dialogowym ustawień aplikacji w programie Flash Professional lub we własnym pliku deskryptora aplikacji. Następnie dodaj plik kompozycji ekranu początkowego, Default.png.

    Opcja -extdir extension-directory pozwala określić katalog zawierający pliki ANE (rozszerzenia natywne) używane przez aplikację. Jeśli aplikacja nie korzysta z rozszerzeń natywnych, nie należy dołączać tej opcji.

    Ważne: W katalogu aplikacji nie należy tworzyć podkatalogu o nazwie Resources . Środowisko wykonawcze automatycznie tworzy folder o tej nazwie, aby zachować zgodność ze strukturą pakietu IPA. Utworzenie własnego folderu Resources spowoduje krytyczny konflikt.

Tworzenie przeznaczonego do debugowania pakietu dla systemu iOS

Aby utworzyć pakiet dla systemu iOS przeznaczony do zainstalowania na urządzeniach testowych, należy użyć polecenia package narzędzia ADT, ustawiając dla typu docelowego wartość ios-debug . Przed wywołaniem tego polecenia należy uzyskać programistyczny certyfikat podpisywania kodu i profil informacyjny od firmy Apple.

adt     -package 
                                -target ipa-debug 
                                -storetype pkcs12 -keystore ../AppleDevelopment.p12 
                                -provisioning-profile AppleDevelopment.mobileprofile 
                                -connect 192.168.0.12 | -listen 
                                myApp.ipa 
                                myApp-app.xml 
                                myApp.swf icons Default.png
Uwaga: Można też użyć opcji ipa-debug-interpreter , która przyspiesza kompilację, lub opcji ipa-debug-interpreter-simulator , która pozwala uruchomić symulator systemu iOS Simulator.

Całe polecenie należy wpisać w jednym wierszu. Znaki podziału wiersza umieszczono w powyższym przykładzie wyłącznie w celu poprawienia czytelności. W powyższym przykładzie założono również, że ścieżka narzędzia ADT znajduje się w definicji ścieżek powłoki wiersza poleceń. (W celu uzyskania pomocy zapoznaj się z tematem Zmienne środowiskowe ścieżek ).

Polecenie należy uruchomić w katalogu zawierającym pliki aplikacji. Plikami aplikacji w tym przykładzie są myApp-app.xml (plik deskryptora aplikacji), myApp.swf, katalog ikon i plik Default.png.

Do podpisania aplikacji należy użyć poprawnego certyfikatu rozpowszechniania wydanego przez firmę Apple. Nie można używać innych certyfikatów podpisywania.

W przypadku debugowania przez sieć Wi-Fi należy użyć opcji -connect . Aplikacja próbuje zainicjować sesję debugowania z programem Flash Debugger (FDB) uruchomionym pod specjalnym adresem IP lub na komputerze o specjalnej nazwie. W przypadku debugowania przez połączenie USB należy użyć opcji -listen . Należy najpierw zainstalować aplikację, a następnie uruchomić narzędzie FDB, które zainicjuje sesję debugowania uruchomionej aplikacji. Więcej informacji zawiera sekcja Nawiązywanie połączenia z debugerem programu Flash .

Tworzenie pakietu dla systemu iOS w celu przesłania do sklepu App Store firmy Apple

Aby utworzyć pakiet systemu iOS w celu przesłania do sklepu App Store firmy Apple, należy użyć polecenia package narzędzia ADT, ustawiając dla typu docelowego wartość ios-app-store . Przed wywołaniem tego polecenia należy uzyskać certyfikat podpisywania kodu do rozpowszechniania i profil informacyjny od firmy Apple.

adt     -package 
                                -target ipa-app-store 
                                -storetype pkcs12 -keystore ../AppleDistribution.p12 
                                -provisioning-profile AppleDistribution.mobileprofile 
                                myApp.ipa 
                                myApp-app.xml 
                                myApp.swf icons Default.png

Całe polecenie należy wpisać w jednym wierszu. Znaki podziału wiersza umieszczono w powyższym przykładzie wyłącznie w celu poprawienia czytelności. W powyższym przykładzie założono również, że ścieżka narzędzia ADT znajduje się w definicji ścieżek powłoki wiersza poleceń. (W celu uzyskania pomocy zapoznaj się z tematem Zmienne środowiskowe ścieżek ).

Polecenie należy uruchomić w katalogu zawierającym pliki aplikacji. Plikami aplikacji w tym przykładzie są myApp-app.xml (plik deskryptora aplikacji), myApp.swf, katalog ikon i plik Default.png.

Do podpisania aplikacji należy użyć poprawnego certyfikatu rozpowszechniania wydanego przez firmę Apple. Nie można używać innych certyfikatów podpisywania.

Ważne: Firma Apple wymaga używania programu Apple Application Loader do przesyłania programów do sklepu App Store. Firma Apple publikuje program Application Loader wyłącznie dla systemu Mac OS X. Opracowując aplikację AIR na telefon iPhone na komputerze z systemem Windows, w celu przesłania aplikacji do sklepu App Store należy więc mieć dostęp do komputera z systemem OS X (w wersji 10.5.3 lub nowszej). Program Application Loader można uzyskać w witrynie iOS Developer Center firmy Apple.

Tworzenie pakietu dla systemu iOS w celu szybkiego rozpowszechniania

Aby utworzyć pakiet dla systemu iOS przeznaczony do szybkiego rozpowszechniania, należy użyć polecenia package narzędzia ADT, ustawiając dla typu docelowego wartość ios-ad-hoc . Przed wywołaniem tego polecenia należy uzyskać odpowiedni certyfikat podpisywania kodu do szybkiego rozpowszechniania i profil informacyjny od firmy Apple.

adt     -package 
                                -target ipa-ad-hoc 
                                -storetype pkcs12 -keystore ../AppleDistribution.p12 
                                -provisioning-profile AppleDistribution.mobileprofile 
                                myApp.ipa 
                                myApp-app.xml 
                                myApp.swf icons Default.png

Całe polecenie należy wpisać w jednym wierszu. Znaki podziału wiersza umieszczono w powyższym przykładzie wyłącznie w celu poprawienia czytelności. W powyższym przykładzie założono również, że ścieżka narzędzia ADT znajduje się w definicji ścieżek powłoki wiersza poleceń. (W celu uzyskania pomocy zapoznaj się z tematem Zmienne środowiskowe ścieżek ).

Polecenie należy uruchomić w katalogu zawierającym pliki aplikacji. Plikami aplikacji w tym przykładzie są myApp-app.xml (plik deskryptora aplikacji), myApp.swf, katalog ikon i plik Default.png.

Do podpisania aplikacji należy użyć poprawnego certyfikatu rozpowszechniania wydanego przez firmę Apple. Nie można używać innych certyfikatów podpisywania.

Tworzenie pakietu systemu iOS dla aplikacji korzystającej z rozszerzeń natywnych

Aby utworzyć pakiet systemu iOS dla aplikacji korzystającej z rozszerzeń natywnych, należy użyć polecenia package narzędzia ADT z opcją -extdir . Polecenie narzędzia ADT powinno zostać użyte w sposób odpowiedni dla danego typu docelowego ( ipa-app-store , ipa-debug , ipa-ad-hoc , ipa-test ). Na przykład:

adt     -package 
                                -target ipa-ad-hoc 
                                -storetype pkcs12 -keystore ../AppleDistribution.p12 
                                -provisioning-profile AppleDistribution.mobileprofile 
                                myApp.ipa 
                                myApp-app.xml 
                                -extdir extensionsDir 
                                myApp.swf icons Default.png

Całe polecenie należy wpisać w jednym wierszu. Znaki podziału wiersza umieszczono w powyższym przykładzie wyłącznie w celu poprawienia czytelności.

Odnośnie rozszerzeń natywnych w przykładzie przyjęto założenie, że katalog o nazwie extensionsDir znajduje się wewnątrz katalogu, w którym jest uruchamiane polecenie. Katalog extensionsDir zawiera pliki ANE używane przez aplikację.