Pacchetti iOS

In iOS, ADT converte il codice byte del file SWF e altri file di origine in un'applicazione iOS nativa.

Create il file SWF con Flash Builder, Flash Professional o un compilatore della riga di comando.
Aprite una shell dei comandi o un terminale e passate alla cartella del progetto dell'applicazione iPhone.
Quindi, utilizzate il tool ADT per creare il file IPA, utilizzando la sintassi seguente:
```
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
```
Modificate il riferimento adt includendo il percorso completo all'applicazione adt. L'applicazione adt è installata nella directory bin di AIR SDK.

Selezionate l'opzione -target che corrisponde al tipo di applicazione iPhone che desiderate creare:
- -target ipa-test : scegliete questa opzione per compilare rapidamente una versione dell'applicazione per la prova sull'iPhone per sviluppatori. potete anche usare ipa-test-interpreter per ottenere una compilazione più veloce o ipa-test-interpreter-simulator per l'esecuzione in iOS Simulator.
- -target ipa-debug : scegliete questa opzione per compilare una versione di debug dell'applicazione per la prova sull'iPhone per sviluppatori. Con questa opzione, potete utilizzare una sessione di debug per ricevere output trace() dall'applicazione iPhone.
  
  Potete includere una delle opzioni -connect seguenti ( CONNECT_OPTIONS ) per specificare l'indirizzo IP del computer di sviluppo che esegue il debugger:
  - -connect - l'applicazione tenta di connettersi via wi-fi a una sessione di debug sul computer di sviluppo utilizzato per compilare l'applicazione.
  - -connect IP_ADDRESS - l'applicazione tenta di connettersi via wi-fi a una sessione di debug sul computer con l'indirizzo IP specificato. Ad esempio:
```
-target ipa-debug -connect 192.0.32.10
```
  - -connect HOST_NAME - l'applicazione tenta di connettersi via wi-fi a una sessione di debug sul computer con il nome host specificato. Ad esempio:
```
-target ipa-debug -connect bobroberts-mac.example.com
```
  L'opzione -connect è opzionale. Se non specificato, l'applicazione di debug risultante non tenterà di connettersi a un debugger residente. In alternativa, potete specificare -listen anziché -connect per abilitare il debugging USB, come descritto in Debug remoto con FDB via USB .
  
  Se una connessione di debug non riesce, l'applicazione visualizza una finestra di dialogo in cui si chiede all'utente di inserire l'indirizzo IP della macchina di debug. Un tentativo di connessione può non riuscire se il dispositivo non è connesso a una rete wifi. Inoltre, questa evenienza si può verificare se il dispositivo è connesso ma non dietro il firewall della macchina host di debug.
  
  potete anche usare ipa-debug-interpreter per ottenere una compilazione più veloce o ipa-debug-interpreter-simulator per l'esecuzione in iOS Simulator.
  
  Per ulteriori informazioni, vedete Debug di un'applicazione AIR per dispositivi mobili .
- -target ipa-ad-hoc : scegliete questa opzione per creare un'applicazione per la distribuzione ad hoc. Visitate il centro per sviluppatori Apple iPhone.
- -target ipa-app-store : scegliete questa opzione per creare una versione finale del file IPA per la distribuzione all'App Store di Apple.
Sostituite PROFILE_PATH con il percorso al file del profilo di provisioning per l'applicazione. Per ulteriori informazioni sui profili di provisioning, vedete Configurazione per iOS .

Usate l'opzione -platformsdk per puntare a iOS Simulator SDK quando realizzate un'applicazione da eseguire in iOS Simulator.

Sostituite SIGNING_OPTIONS per fare riferimento al certificato e alla password per sviluppatori iPhone. Utilizzate la sintassi seguente:
```
-storetype pkcs12 -keystore P12_FILE_PATH -storepass PASSWORD
```
Sostituite P12_FILE_PATH con il percorso al file di certificato P12. Sostituite PASSWORD con la password del certificato. (Vedete l'esempio riportato di seguito.) Per ulteriori informazioni sul file del certificato P12, vedete Conversione di un certificato per sviluppatori in un file di archivio chiavi P12 .

Nota: potete utilizzare un certificato autofirmato quando compilate per iOS Simulator.

Sostituite APP_DESCRIPTOR per fare riferimento al file descrittore dell'applicazione.

Sostituite SOURCE_FILES per fare riferimento al file SWF principale del progetto seguito dalle eventuali altre risorse da includere. Includete i percorsi a tutti i file delle icone definiti nella finestra di dialogo delle impostazioni dell'applicazione in Flash Professional o in un file descrittore dell'applicazione personalizzato. Inoltre, aggiungete il file grafico della schermata iniziale, Default.png.

Utilizzate l'opzione -extdir extension-directory per specificare la directory contenente i file ANE (estensioni native) utilizzati dall'applicazione. Se l'applicazione non usa estensioni native, non includete questa opzione.

Importante: non create una sottodirectory Resources nella directory dell'applicazione. Il runtime crea automaticamente una cartella con questo nome per assicurare la conformità con la struttura di pacchetto IPA. La creazione di una vostra cartella Resources determinerebbe un conflitto non risolvibile.

Creazione di un pacchetto iOS per il debug

Per creare un pacchetto iOS da installare su dispositivi di prova, usate il comando ADT package, impostando il tipo di target su ios-debug . Prima di eseguire questo comando, dovete essere già in possesso di un certificato di firma del codice per sviluppatori e di un profilo di provisioning forniti da 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

Nota: potete anche usare ipa-debug-interpreter per ottenere una compilazione più veloce o ipa-debug-interpreter-simulator per eseguire in iOS Simulator.

Digitate l'intero comando su una sola riga; le interruzioni di riga nell'esempio qui sopra sono presenti solo per facilitare la leggibilità. Inoltre, nell'esempio si presume che il percorso del tool ADT sia nella definizione di percorso della vostra shell della riga di comando. (Vedete Variabili d'ambiente dei percorsi per ulteriori informazioni.)

Dovete eseguire il comando dalla directory che contiene i file dell'applicazione. Nell'esempio, i file dell'applicazione sono myApp-app.xml (il file descrittore dell'applicazione), myApp.swf, una directory di icone e il file Default.png.

Dovete firmare l'applicazione usando il corretto certificato di distribuzione emesso da Apple; altri certificati di firma del codice non sono validi.

Utilizzate l'opzione -connect per il debug via wi-fi. L'applicazione tenta di avviare una sessione di debug con l'istanza di Flash Debugger (FDB) eseguita sull'IP o nome host specificato. Utilizzate l'opzione -listen per il debug via USB. Prima avviate l'applicazione e poi FDB, che apre una sessione di debug per l'applicazione in esecuzione. Vedete Connessione al debugger di Flash per ulteriori informazioni.

Creazione di un pacchetto iOS per l'invio a Apple App Store

Per creare un pacchetto iOS da inviare ad Apple App Store, usate il comando ADT package, impostando il tipo di target su ios-app-store . Prima di eseguire questo comando, dovete essere già in possesso di un certificato di firma del codice per la distribuzione e di un profilo di provisioning forniti da 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

Dovete firmare l'applicazione usando il corretto certificato di distribuzione emesso da Apple; altri certificati di firma del codice non sono validi.

Importante: Apple richiede l'uso del programma Apple Application Loader per caricare applicazioni su App Store. Tuttavia, Apple pubblica Application Loader solo per Mac OS X e quindi, anche se potete sviluppare un'applicazione AIR per iPhone usando un computer Windows, dovete avere accesso a un computer con sistema operativo OS X (versione 10.5.3 o successiva) per inviarla ad App Store. Il programma Application Loader può essere scaricato da Apple iOS Developer Center.

Creazione di un pacchetto iOS per la distribuzione ad hoc

Per creare un pacchetto iOS per la distribuzione ad hoc, usate il comando ADT package, impostando il tipo di target su ios-ad-hoc . Prima di eseguire questo comando, dovete essere già in possesso del certificato di firma del codice per la distribuzione ad hoc e di un profilo di provisioning appropriati forniti da 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

Dovete firmare l'applicazione usando il corretto certificato di distribuzione emesso da Apple; altri certificati di firma del codice non sono validi.

Creazione di un pacchetto iOS per un'applicazione che usa estensioni native

Per creare un pacchetto iOS per un'applicazione che usa estensioni native, usate il comando del pacchetto ADT con l'opzione -extdir . Usate il comando ADT in base alle destinazioni ( ipa-app-store , ipa-debug , ipa-ad-hoc , ipa-test ). Ad esempio:

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

Digitate l'intero comando su una sola riga; le interruzioni di riga nell'esempio qui sopra sono presenti solo per facilitare la leggibilità.

Per quanto riguarda le estensioni native, nell'esempio si presume che la directory denominata extensionsDir sia la directory nella quale eseguite il comando. La directory extensionsDir contiene i file ANE utilizzati dall'applicazione.