Elementi del descrittore dell'applicazione AIR

Consente all'API AIR interna al browser di rilevare e avviare l'applicazione.

Se impostate questo valore su true , tenete presenti le implicazioni di sicurezza descritte in Chiamata di un'applicazione AIR dal browser (sviluppatori ActionScript) e Invoking an AIR application from the browser (sviluppatori HTML).

Per maggiori informazioni, vedete Avvio dal browser di un'applicazione AIR installata .

Elemento superiore: application

Elementi secondari: nessuno

<allowBrowserInvocation>true</allowBrowserInvocation>

Consente di aggiungere elementi al file manifest di Android. AIR crea il file AndroidManifest.xml per ogni pacchetto APK. Potete usare l'elemento android nel descrittore dell'applicazione AIR per aggiungere ad esso ulteriori voci. Ignorato su tutte le piattaforme eccetto Android.

Elemento superiore: application

Elementi secondari:

• colorDepth

• manifestAdditions

<android> 
    <manifestAdditions> 
        ... 
    </manifestAdditions> 
</android>

L'elemento principale (root) di un documento descrittore dell'applicazione AIR.

Elemento superiore: nessuno

Elementi secondari:

• allowBrowserInvocation

• android

• copyright

• customUpdateUI

• description

• extensions

• filename

• fileTypes

• icon

• id

• initialWindow

• installFolder

• iPhone

• name

• programMenuFolder

• publisherID

• supportedLanguages

• supportedProfiles

• version

• versionLabel

• versionNumber

xmlns="http://ns.adobe.com/air/application/1.0" 
xmlns="http://ns.adobe.com/air/application/1.1" 
xmlns="http://ns.adobe.com/air/application/1.5" 
xmlns="http://ns.adobe.com/air/application/1.5.2" 
xmlns="http://ns.adobe.com/air/application/1.5.3" 
xmlns="http://ns.adobe.com/air/application/2.0" 
xmlns="http://ns.adobe.com/air/application/2.5" 
xmlns="http://ns.adobe.com/air/application/2.6" 
xmlns="http://ns.adobe.com/air/application/2.7" 
xmlns="http://ns.adobe.com/air/application/3.0" 
xmlns="http://ns.adobe.com/air/application/3.1" 
xmlns="http://ns.adobe.com/air/application/3.2" 
xmlns="http://ns.adobe.com/air/application/3,3" 
xmlns="http://ns.adobe.com/air/application/3.4" 
xmlns="http://ns.adobe.com/air/application/3.5" 
xmlns="http://ns.adobe.com/air/application/3.6" 
xmlns="http://ns.adobe.com/air/application/3.7"

<?xml version="1.0" encoding="utf-8" ?> 
<application xmlns="http://ns.adobe.com/air/application/3.0"> 
    <id>HelloWorld</id> 
    <version>2.0</version> 
    <filename>Hello World</filename> 
    <name>Example Co. AIR Hello World</name> 
     <description> 
        <text xml:lang="en">This is an example.</text> 
        <text xml:lang="fr">C'est un exemple.</text> 
        <text xml:lang="es">Esto es un ejemplo.</text> 
    </description> 
    <copyright>Copyright (c) 2010 Example Co.</copyright> 
    <initialWindow> 
        <title>Hello World</title> 
        <content> 
            HelloWorld.swf 
        </content> 
        <systemChrome>none</systemChrome> 
        <transparent>true</transparent> 
        <visible>true</visible> 
        <minSize>320 240</minSize> 
    </initialWindow>  
    <installFolder>Example Co/Hello World</installFolder> 
    <programMenuFolder>Example Co</programMenuFolder> 
    <icon> 
        <image16x16>icons/smallIcon.png</image16x16> 
        <image32x32>icons/mediumIcon.png</image32x32> 
        <image48x48>icons/bigIcon.png</image48x48> 
        <image128x128>icons/biggestIcon.png</image128x128>  
    </icon> 
    <customUpdateUI>true</customUpdateUI> 
    <allowBrowserInvocation>false</allowBrowserInvocation> 
    <fileTypes> 
        <fileType> 
            <name>adobe.VideoFile</name> 
            <extension>avf</extension> 
            <description>Adobe Video File</description> 
            <contentType>application/vnd.adobe.video-file</contentType> 
            <icon> 
                <image16x16>icons/avfIcon_16.png</image16x16> 
                <image32x32>icons/avfIcon_32.png</image32x32> 
                <image48x48>icons/avfIcon_48.png</image48x48> 
                <image128x128>icons/avfIcon_128.png</image128x128> 
            </icon> 
        </fileType> 
    </fileTypes> 
</application>

Specifica le proporzioni dell'applicazione.

Se non è specificato, l'applicazione si apre con le proporzioni e l'orientamento "naturali" del dispositivo. L'orientamento naturale varia da dispositivo a dispositivo. In genere, è l'orientamento verticale nei dispositivi con display di piccole dimensioni, come i telefoni. Su alcuni dispositivi, come il tablet iPad, l'applicazione si apre con l'orientamento corrente. In AIR 3.3 e versioni successive, questa impostazione si applica all'intera applicazione, non solo alla visualizzazione iniziale.

Elemento superiore: initialWindow

Elementi secondari: nessuno

<aspectRatio>landscape</aspectRatio>

Specifica se il contenuto dell'applicazione si riorienta automaticamente quando l'orientamento fisico del dispositivo cambia. Per maggiori informazioni, consultate Orientamento stage .

Quando utilizzate l'orientamento automatico, valutate se impostare le proprietà align e scaleMode dello Stage sui valori seguenti:

stage.align = StageAlign.TOP_LEFT; 
stage.scaleMode = StageScaleMode.NO_SCALE;

Queste impostazioni consentono all'applicazione di ruotare intorno all'angolo superiore sinistro e impediscono che il contenuto dell'applicazione venga ridimensionato automaticamente. Anche se le altre modalità di ridimensionamento adattano il contenuto in base alle dimensioni dello stage ruotato, hanno anche l'effetto di troncare, distorcere o ridurre eccessivamente il contenuto stesso. Il risultato migliore si può ottenere quasi sempre ridisegnando manualmente il contenuto.

Elemento superiore: initialWindow

Elementi secondari: nessuno

<autoOrients>true</autoOrients>

Specifica se utilizzare il colore a 16 bit o a 32 bit.

L'uso del colore a 16 bit può migliorare le prestazioni di rendering, ma con una riduzione della fedeltà dei colori. Prima di AIR 3, il colore a 16 bit veniva sempre utilizzato in Android. In AIR 3, viene utilizzato per impostazione predefinita il colore a 32 bit.

Elemento superiore: android

Elementi secondari: nessuno

<android> 
    <colorDepth>16bit</colorDepth> 
    <manifestAdditions>...</manifestAdditions> 
</android>

Specifica se l'applicazione conterrà o meno un contenuto video.

Elemento superiore: android

Elementi secondari: nessuno

<android> 
    <containsVideo>true</containsVideo> 
    <manifestAdditions>...</manifestAdditions> 
</android>

Il valore specificato per l'elemento content è l'URL del file di contenuto principale dell'applicazione. Può trattarsi di un file SWF o HTML. L'URL è specificato in relazione al livello principale della cartella di installazione dell'applicazione. (Quando si esegue un'applicazione AIR con ADL, l'URL è relativo alla cartella contenente il file descrittore dell'applicazione. È possibile utilizzare il parametro root-dir di ADL per specificare una directory principale diversa.)

Elemento superiore: initialWindow

Elementi secondari: nessuno

<content>TravelPlanner.swf</content>

contentType è obbligatorio a partire da AIR 1.5 (era facoltativo in AIR 1.0 e 1.1). La proprietà permette ad alcuni sistemi operativi di individuare più facilmente l'applicazione più indicata per l'apertura di un file. Il valore deve essere il tipo MIME del contenuto del file. Tenete presente che il valore viene ignorato in Linux se il tipo di file è già registrato ed è stato associato a un tipo MIME.

Elemento superiore: fileType

Elementi secondari: nessuno

<contentType>text/plain</contentType>

Le informazioni di copyright per l'applicazione AIR. In Mac OS, il testo di copyright appare nella finestra di dialogo Informazioni su per l'applicazione installata. In Mac OS, le informazioni di copyright sono utilizzate anche nel campo NSHumanReadableCopyright del file Info.plist per l'applicazione.

Elemento superiore: application

Elementi secondari: nessuno

<copyright>© 2010, Examples, Inc.All rights reserved.</copyright>

Indica se un'applicazione fornisce le proprie finestre di aggiornamento. Se è false , AIR presenta all'utente le finestre di aggiornamento standard. Solo le applicazioni distribuite come file AIR possono utilizzare il sistema di aggiornamento incorporato di AIR.

Quando la versione installata dell'applicazione ha l'elemento customUpdateUI impostato su true e l'utente fa doppio clic sul file AIR di una nuova versione o installa un aggiornamento dell'applicazione mediante la funzionalità di installazione invisibile, il runtime apre la versione installata dell'applicazione, anziché il programma di installazione dell'applicazione AIR predefinito. La logica dell'applicazione può quindi determinare come procedere con l'operazione di aggiornamento. (Affinché sia possibile procedere all'aggiornamento, l'ID applicazione e l'ID editore del file AIR devono corrispondere ai valori dell'applicazione installata.)

Per ulteriori informazioni, vedete Aggiornamento di applicazioni AIR .

Elemento superiore: application

Elementi secondari: nessuno

<customUpdateUI>true</customUpdateUI>

Indica che l'applicazione richiede l'uso del buffer di profondità o di stencil. Solitamente questi buffer vengono utilizzati quando si lavora con contenuti 3D. Per impostazione predefinita, il valore di questo elemento è false , che disattiva i buffer di profondità e di stencil. L'elemento è necessario perché i buffer devono essere allocati all'avvio dell'applicazione, prima che venga caricato qualsiasi contenuto.

L'impostazione di questo elemento deve corrispondere al valore passato per l'argomento enableDepthAndStencil del metodo Context3D.configureBackBuffer() . Se i valori non corrispondono, AIR genera un errore.

Questo elemento è applicabile solo quando renderMode = direct . Se renderMode non è uguale a direct, ADT genera l'errore 118:

<depthAndStencil> element unexpected for render mode cpu.  It requires "direct" render mode.

Elemento superiore: initialWindow

Elementi secondari: nessuno

<depthAndStencil>true</depthAndStencil>

La descrizione dell'applicazione visualizzata nel programma di installazione dell'applicazione AIR.

Se si specifica un unico nodo di testo (non più elementi testo), il programma di installazione dell'applicazione AIR utilizza questa descrizione, a prescindere dalla lingua del sistema. In caso contrario, il programma di installazione dell'applicazione AIR utilizza la descrizione che più corrisponde alla lingua dell'interfaccia utente del sistema operativo dell'utente. Ad esempio, considerate un'installazione in cui l'elemento description del file descrittore dell'applicazione comprende un valore per la versione locale en (inglese). Il programma di installazione dell'applicazione AIR utilizza la descrizione inglese se il sistema dell'utente identifica en (inglese) come lingua dell'interfaccia utente. Utilizza la descrizione inglese anche se la lingua dell'interfaccia utente del sistema è en-US (inglese americano). Tuttavia, se la lingua dell'interfaccia utente del sistema è en-US e il file descrittore dell'applicazione definisce i nomi en-US ed en-GB, il programma di installazione dell'applicazione AIR utilizza il valore en-US. Se l'applicazione non definisce alcuna descrizione che corrisponda alla lingua dell'interfaccia utente del sistema, il programma di installazione dell'applicazione AIR utilizza il primo valore description definito nel file descrittore dell'applicazione.

Per ulteriori informazioni sullo sviluppo di applicazioni multilingue, vedete Localizzazione di applicazioni AIR .

Elemento superiore: application

Elementi secondari: text

<description>This is a sample AIR application.</description> 

<description> 
    <text xml:lang="en">This is an example.</text> 
    <text xml:lang="fr">C'est un exemple.</text> 
    <text xml:lang="es">Esto es un ejemplo.</text> 
</description> 

La descrizione del tipo di file viene visualizzata all'utente dal sistema operativo. Non è localizzabile.

Vedete anche: description come elemento secondario dell'elemento application

Elemento superiore: fileType

Elementi secondari: nessuno

<description>PNG image</description>

Consente di utilizzare font personalizzati per StageText nell'applicazione AIR. Questo elemento è opzionale.

Elemento superiore: application

Elementi secondari: font

<embedFonts> 
   <font> 
      <fontPath>ttf/space age.ttf</fontPath>
      <fontName>space age</fontName> 
   </font>
   <font> 
      <fontPath>ttf/xminus.ttf</fontPath>
      <fontName>xminus</fontName> 
   </font>
</embedFonts>

iOS impiega proprietà denominate entitlements per consentire all'applicazione di accedere a risorse e funzionalità aggiuntive. Utilizzate l'elemento Entitlements per specificare questa informazione in un'applicazione iOS mobile.

Elemento superiore: iPhone

Elementi secondari: elementi iOS Entitlements.plist

<iphone> 
... 
   <Entitlements> 
      <![CDATA[ 
         <key>aps-environment</key> 
         <string>development</string> 
      ]]> 
   </Entitlements> 
</iphone>

La stringa di estensione di un tipo di file.

Elemento superiore: fileType

Elementi secondari: nessuno

<extension>png</extension>

Specifica l'ID di un'estensione ActionScript utilizzato dall'applicazione. L'ID è definito nel documento descrittore dell'estensione.

Elemento superiore: extensions

Elementi secondari: nessuno

<extensionID>com.example.extendedFeature</extensionID>

Identifica le estensioni ActionScript utilizzate da un'applicazione.

Elemento superiore: application

Elementi secondari: extensionID

<extensions> 
    <extensionID>extension.first</extensionID> 
    <extensionID>extension.next</extensionID> 
    <extensionID>extension.last</extensionID> 
</extensions>

Specifica il nome di un file di testo contenente l'elenco di file SWF che verranno configurati da ADT per l'hosting remoto. Potete ridurre le dimensioni iniziali di download dell'applicazione creando un pacchetto con un sottoinsieme di SWF utilizzati dall'applicazione, quindi caricando i rimanenti SWF esterni (di sole risorse) in fase di runtime mediante il metodo Loader.load() . Per utilizzare questa funzione, create l'applicazione in modo che ADT sposti tutti i componenti ActionScript ByteCode (ABC) dai file SWF caricati esternamente all'SWF dell'applicazione principale, dando origine a un file SWF che contiene soltanto risorse. In tal modo viene rispettata la regola di Apple Store che non consente il download di codice aggiuntivo dopo l'installazione di un'applicazione.

Per ulteriori informazioni, consultate Riduzione delle dimensioni di download tramite il caricamento di SWF esterni di sole risorse .

Elemento superiore: iPhone , initialWindow

Elementi secondari: nessuno

<iPhone> 
    <externalSwfs>FileContainingListofSWFs.txt</externalSwfs> 
</iPhone>

La stringa da utilizzare come nome file dell'applicazione (senza estensione) quando viene installata l'applicazione. Il file dell'applicazione avvia l'applicazione AIR nel runtime. Se non viene fornito un valore name , filename viene utilizzato anche come nome della cartella di installazione.

Elemento superiore: application

Elementi secondari: nessuno

<filename>MyApplication</filename>

Descrive un singolo tipo di file per il quale l'applicazione può registrarsi.

Elemento superiore: fileTypes

Elementi secondari:

• contentType

• description

• extension

• icon

• name

<fileType> 
    <name>foo.example</name> 
    <extension>foo</extension> 
    <description>Example file type</description> 
    <contentType>text/plain</contentType> 
    <icon> 
        <image16x16>icons/fooIcon16.png</image16x16> 
        <image48x48>icons/fooIcon48.png</imge48x48> 
    <icon> 
</fileType>

L'elemento fileTypes consente di dichiarare i tipi di file ai quali è possibile associare un'applicazione AIR.

Quando un'applicazione AIR viene installata, qualsiasi tipo di file dichiarato viene registrato nel sistema operativo. Se questi tipi di file non sono già associati a un'altra applicazione, vengono associati all'applicazione AIR. Per sostituire un'associazione esistente tra un tipo di file e un'altra applicazione, utilizzate il metodo NativeApplication.setAsDefaultApplication() in fase runtime (preferibilmente con il permesso dell'utente).

L'elemento fileTypes è opzionale.

Elemento superiore: application

Elementi secondari: fileType

<fileTypes> 
    <fileType> 
        <name>adobe.VideoFile</name> 
        <extension>avf</extension> 
        <description>Adobe Video File</description> 
        <contentType>application/vnd.adobe.video-file</contentType> 
        <icon> 
            <image16x16>icons/AIRApp_16.png</image16x16>       
            <image32x32>icons/AIRApp_32.png</image32x32>       
            <image48x48>icons/AIRApp_48.png</image48x48>      
            <image128x128>icons/AIRApp_128.png</image128x128> 
        </icon> 
    </fileType> 
</fileTypes>

Descrive un singolo font personalizzato che può essere utilizzato nell'applicazione AIR.

Elemento superiore: embedFonts

Elementi secondari: fontName , fontPath

<font> 
   <fontPath>ttf/space age.ttf</fontPath>
   <fontName>space age</fontName> 
</font>

Specifica il nome di un font personalizzato.

Elemento superiore: font

Elementi secondari: nessuno

<fontName>space age</fontName> 

Percorso del file del font personalizzato.

Elemento superiore: font

Elementi secondari: nessuno

<fontPath>ttf/space age.ttf</fontPath> 

Impone la modalità di rendering CPU per un insieme di dispositivi specificato. Questa funzione consente di abilitare in modo selettivo ed efficiente la modalità di rendering GPU per i rimanenti dispositivi iOS.

Aggiungete questo tag come tag secondario del tag iPhone e specificate un elenco separato da spazi contenente i nomi di modello dei dispositivi. I nomi di modello dei dispositivi validi includono i seguenti:

Elemento superiore: iPhone , initialWindow

Elementi secondari: nessuno

... 
<renderMode>GPU</renderMode> 
... 
<iPhone> 
... 
   <forceCPURenderModeForDevices>iPad1,1 iPhone1,1 iPhone1,2 iPod1,1 
   </forceCPURenderModeForDevices> 
</iPhone>

Specifica se l'applicazione viene avviata in modalità a schermo intero.

Elemento superiore: initialWindow

Elementi secondari: nessuno

<fullscreen>true</fullscreen>

L'altezza iniziale della finestra principale dell'applicazione.

Se non impostate l'altezza, questa viene determinata dalle impostazioni del file SWF principale oppure, nel caso di un'applicazione AIR basata su HTML, dal sistema operativo.

L'altezza massima di una finestra è cambiata da 2048 pixel a 4096 pixel in AIR 2.

Elemento superiore: initialWindow

Elementi secondari: nessuno

<height>4095</height>

La proprietà icon specifica uno o più file di icona da utilizzare per l'applicazione. L'inclusione di un'icona è opzionale. Se non si specifica una proprietà icon , il sistema operativo visualizza un'icona predefinita.

Il percorso specificato è relativo alla directory principale dell'applicazione. I file di icona devono essere in formato PNG. Potete specificare tutte le dimensioni seguenti per le icone:

Se è presente un elemento per una determinata dimensione, l'immagine nel file deve essere esattamente della dimensione specificata. Se non vengono specificate tutte le dimensioni, quelle più simili vengono adattate per un determinato uso dell'icona da parte del sistema operativo.

Per ottenere un risultato ottimale, specificate un'immagine per ciascuna delle dimensioni disponibili. Inoltre, assicuratevi che le icone siano visualizzabili nelle modalità a colori a 16 e a 32 bit.

Elemento superiore: application

Elementi secondari: imageNxN

<icon> 
    <image16x16>icons/smallIcon.png</image16x16> 
    <image32x32>icons/mediumIcon.png</image32x32> 
    <image48x48>icons/bigIcon.png</image48x48> 
    <image128x128>icons/biggestIcon.png</image128x128>  
</icon>

Una stringa di identificazione per l'applicazione, detta ID applicazione. Spesso viene utilizzato un identificatore in stile DNS inverso, ma non è indispensabile usare questo stile.

Elemento superiore: application

Elementi secondari: nessuno

<id>org.example.application</id>

Definisce il percorso di un'icona rispetto alla directory dell'applicazione.

Possono essere utilizzate le seguenti immagini di icone, ciascuna con una dimensione icona differente:

• image16x16

• image29x29 (AIR 2+)

• image32x32

• image36x36 (AIR 2.5+)

• image48x48

• image50x50 (AIR 3.4+)

• image57x57 (AIR 2+)

• image58x58 (AIR 3.4+)

• image72x72 (AIR 2+)

• image100x100 (AIR 3.4+)

• image114x114 (AIR 2.6+)

• image128x128

• image144x144 (AIR 3.4+)

• image512x512 (AIR 2+)

• image1024x1024 (AIR 3.4+)

L'icona deve essere un'immagine PNG esattamente delle dimensioni indicate dall'elemento image. I file di icone devono essere inclusi nel pacchetto dell'applicazione; le icone associate a riferimenti nel documento descrittore dell'applicazione non vengono incluse automaticamente.

Elemento superiore: application

Elementi secondari: nessuno

<image32x32>icons/icon32.png</image32x32>

Permette di specificare proprietà aggiuntive in un'applicazione iOS.

Elemento superiore: iPhone

Elementi secondari: elementi iOS Info.plist

<InfoAdditions> 
    <![CDATA[ 
        <key>UIStatusBarStyle</key> 
        <string>UIStatusBarStyleBlackOpaque</string> 
        <key>UIRequiresPersistentWiFi</key> 
        <string>NO</string> 
    ]]> 
</InfoAdditions>

Definisce il file di contenuto principale e l'aspetto iniziale dell'applicazione.

Elemento superiore: application

<initialWindow> 
    <title>Hello World</title> 
    <content> 
        HelloWorld.swf 
    </content> 
    <depthAndStencil>true</depthAndStencil> 
    <systemChrome>none</systemChrome> 
    <transparent>true</transparent> 
    <visible>true</visible> 
    <maxSize>1024 800</maxSize> 
    <minSize>320 240</minSize> 
    <maximizable>false</maximizable> 
    <minimizable>false</minimizable> 
    <resizable>true</resizable> 
    <x>20</x> 
    <y>20</y> 
    <height>600</height> 
    <width>800</width> 
    <aspectRatio>landscape</aspectRatio> 
    <autoOrients>true</autoOrients> 
    <fullScreen>false</fullScreen> 
    <renderMode>direct</renderMode> 
</initialWindow>

Identifica la sottodirectory della directory di installazione predefinita.

In Windows, la sottodirectory di installazione predefinita è Programmi. In Mac OS, è la directory /Applicazioni. In Linux è /opt/. Se, ad esempio, la proprietà installFolder è impostata su "Acme" e un'applicazione è denominata "ExampleApp" , l'applicazione viene installata in C:\Programmi\Acme\ExampleApp in Windows, in /Applicazioni/Acme/Example.app in MacOS e in /opt/Acme/ExampleApp in Linux.

La proprietà installFolder è opzionale. Se non viene specificata, l'applicazione viene installata in una sottodirectory della directory di installazione predefinita, in base alla proprietà name .

Elemento superiore: application

Elementi secondari: nessuno

<installFolder>utilities/toolA</installFolder>

Definisce proprietà dell'applicazione specifiche per iOS.

Elemento superiore: application

Specifica informazioni da aggiungere al file manifest di Android per l'applicazione.

Elemento superiore: manifestAdditions

Elementi secondari: definiti da Android SDK.

<![CDATA[      
    <manifest android:sharedUserID="1001"> 
        <uses-permission android:name="android.permission.CAMERA"/> 
        <uses-feature android:required="false" android:name="android.hardware.camera"/> 
        <application     android:allowClearUserData="true" 
                    android:enabled="true" 
                    android:persistent="true"/> 
    </manifest> 
]]>

Specifica informazioni da aggiungere al file manifest di Android.

Ogni applicazione Android include un file manifest che definisce le proprietà di base dell'applicazione stessa. Il manifest Android è concettualmente simile al descrittore dell'applicazione AIR. Un'applicazione AIR for Android ha sia un descrittore dell'applicazione che un file manifest Android generato automaticamente. Quando viene creato il pacchetto di un'applicazione AIR for Android, le informazioni presenti in questo elemento manifestAdditions vengono aggiunte alle parti corrispondenti del documento manifest Android.

Elemento superiore: android

Elementi secondari: manifest

<manifestAdditions> 
    <![CDATA[      
        <manifest android:installLocation="preferExternal"> 
            <uses-permission android:name="android.permission.INTERNET"/> 
            <application     android:allowClearUserData="true" 
                        android:enabled="true" 
                        android:persistent="true"/> 
        </manifest> 
    ]]> 
</manifestAdditions>

Specifica se la finestra può essere ingrandita.

Elemento superiore: initialWindow

Elementi secondari: nessuno

<maximizable>false</maximizable>

le dimensioni massime di una finestra. Se non impostate una dimensione massima, questa viene determinata dal sistema operativo.

Elemento superiore: initialWindow

Elementi secondari: nessuno

<maxSize>1024 360</maxSize>

Specifica se la finestra può essere ridotta a icona.

Elemento superiore: initialWindow

Elementi secondari: nessuno

<minimizable>false</minimizable>

Specifica la dimensione minima consentita per la finestra.

Elemento superiore: initialWindow

Elementi secondari: nessuno

<minSize>120 60</minSize>

Il titolo dell'applicazione visualizzato nel programma di installazione dell'applicazione AIR.

Se non è specificato alcun elemento name , il programma di installazione dell'applicazione AIR visualizza il valore filename come nome dell'applicazione.

Elemento superiore: application

Elementi secondari: text

<name>Test Application</name> 

<name> 
    <text xml:lang="en">Hello AIR</text> 
    <text xml:lang="fr">Bonjour AIR</text> 
    <text xml:lang="es">Hola AIR</text> 
</name> 

Identifica il nome di un tipo di file.

Elemento superiore: fileType

Elementi secondari: nessuno

<name>adobe.VideoFile</name>

Identifica il percorso in cui posizionare i collegamenti all'applicazione nel menu Tutti i programmi del sistema operativo Windows o nel menu Applications di Linux. (Questa impostazione è attualmente ignorata in altri sistemi operativi.)

Elemento superiore: application

Elementi secondari: nessuno

<programMenuFolder>Example Company/Sample Application</programMenuFolder>

Identifica l'ID editore per l'aggiornamento di un'applicazione AIR originariamente creata con AIR versione 1.5.2 o precedente.

Specificate un ID editore solo quando create l'aggiornamento di un'applicazione. Il valore dell'elemento publisherID deve corrispondere all'ID editore generato da AIR per la versione precedente dell'applicazione. Per un'applicazione installata, l'ID editore si trova nella cartella di installazione dell'applicazione, nel file META-INF/AIR/publisherid .

Per le nuove applicazioni create con AIR 1.5.3 e versioni successive l'ID editore non deve essere specificato.

Per ulteriori informazioni, vedete Informazioni sugli ID editore AIR .

Elemento superiore: application

Elementi secondari: nessuno

<publisherID>B146A943FBD637B68C334022D304CEA226D129B4.1</publisherID>

Specifica se deve essere utilizzata l'accelerazione GPU, se supportata dal dispositivo corrente.

Elemento superiore: initialWindow

Elementi secondari: nessuno

<renderMode>direct</renderMode>

Specifica se l'applicazione richiede la risoluzione standard o elevata in un dispositivo o in un monitor per computer con schermo ad alta risoluzione. Se impostato su standard (valore predefinito), lo schermo apparirà all'applicazione come schermo a risoluzione standard. Se la risoluzione impostata è elevata , l'applicazione può utilizzare ogni pixel in alta risoluzione.

Ad esempio, su uno schermo iPhone ad alta risoluzione da 640x960, se l'impostazione è standard le dimensioni a schermo intero dello stage sono 320x480 e ciascun pixel dell'applicazione è renderizzato utilizzando quattro pixel dello schermo. Se la risoluzione è impostata su elevata , le dimensioni a schermo intero dello stage corrispondono a 640x960.

Nei dispositivi con schermi a risoluzione standard, le dimensioni dello stage corrispondono alle dimensioni dello schermo, indipendentemente dall'impostazione utilizzata.

Se l'elemento requestedDisplayResolution è nidificato nell'elemento iPhone , viene applicato ai dispositivi iOS. In questo caso, l'attributo excludeDevices può essere utilizzato per specificare i dispositivi per i quali non è applicata l'impostazione.

Se l'elemento requestedDisplayResolution è nidificato nell'elemento initialWindow , viene applicato alle applicazioni AIR desktop su computer MacBook Pro che supportano display ad alta risoluzione. Il valore specificato viene applicato a tutte le finestre native utilizzate nell'applicazione. La nidificazione dell'elemento requestedDisplayResolution nell'elemento initialWindow è supportata in AIR 3.6 e versioni successive.

Elemento superiore: iPhone , initialWindow

Elementi secondari: nessuno

<initialWindow> 
    <requestedDisplayResolution>high</requestedDisplayResolution> 
</initialWindow>

<iPhone> 
    <requestedDisplayResolution excludeDevices="iPad3 iPad4">high</requestedDisplayResolution> 
</iPhone>

Specifica se la finestra può essere ridimensionata.

Elemento superiore: initialWindow

Elementi secondari:

<resizable>false</resizable>

Specifica il comportamento predefinito dell'applicazione quando è visualizzata una tastiera virtuale. Il comportamento predefinito è lo scorrimento verso l'alto dell'applicazione. Il runtime mantiene visibile sullo schermo il campo di testo o oggetto interattivo attualmente attivato. Usate l'opzione pan se l'applicazione non fornisce una propria logica per la gestione della tastiera.

Potete anche disattivare il comportamento automatico impostando l'elemento softKeyboardBehavior su none . In questo caso, i campi di testo e gli oggetti interattivi inviano un evento SoftKeyboardEvent quando viene visualizzata la tastiera virtuale, ma il runtime non esegue lo scorrimento o il ridimensionamento dell'applicazione. È quindi compito dell'applicazione mantenere visibile l'area di immissione del testo.

Elemento superiore: initialWindow

Elementi secondari: nessuno

<softKeyboardBehavior>none</softKeyboardBehavior>

Identifica le lingue supportate dall'applicazione. Questo elemento è utilizzato solo da iOS, dal runtime autonomo Mac e dalle applicazioni Android. Viene ignorato da tutti gli altri tipi di applicazioni.

Se non specificate questo elemento, l'impostazione predefinita prevede che il compilatore esegua le operazioni seguenti in base al tipo di applicazione:

Elemento superiore: application

Elementi secondari: nessuno

<supportedLanguages>en ja fr es</supportedLanguages>

Identifica i profili supportati per l'applicazione.

Elemento superiore: application

Elementi secondari: nessuno

<supportedProfiles>desktop extendedDesktop</supportedProfiles>

<supportedProfiles>desktop mobileDevice</supportedProfiles>

Specifica se la finestra iniziale dell'applicazione viene creata con gli elementi standard (barra del titolo, bordi e controlli) forniti dal sistema operativo.

L'impostazione del chrome di sistema della finestra non può essere modificata in fase runtime.

Elemento superiore: initialWindow

Elementi secondari: nessuno

<systemChrome>standard</systemChrome>

Specifica una stringa localizzata.

L'attributo xml:lang di un elemento di testo specifica un codice lingua, definito dallo standard RFC4646 (http://www.ietf.org/rfc/rfc4646.txt).

Il programma di installazione dell'applicazione AIR utilizza l'elemento text con il valore dell'attributo xml:lang più simile alla lingua dell'interfaccia utente del sistema operativo dell'utente.

Ad esempio, considerate un'installazione in cui un elemento text comprende un valore per la versione locale en (inglese). Il programma di installazione dell'applicazione AIR utilizza il nome en se il sistema operativo identifica en (inglese) come lingua dell'interfaccia utente. Utilizza anche il nome en se la lingua dell'interfaccia utente del sistema è en-US (inglese americano). Tuttavia, se la lingua dell'interfaccia utente è en-US e il file descrittore dell'applicazione definisce i nomi en-US ed en-GB, quindi il programma di installazione dell'applicazione AIR utilizza il valore en-US.

Se l'applicazione non definisce un elemento text che corrisponda alle lingue dell'interfaccia utente del sistema, il programma di installazione dell'applicazione AIR utilizza il primo valore name definito nel file descrittore dell'applicazione.

Elementi secondari: nessuno

<text xml:lang="fr">Bonjour AIR</text>

Specifica il titolo visualizzato nella barra del titolo della finestra iniziale dell'applicazione.

Il titolo viene visualizzato solo se l'elemento systemChrome è impostato su standard .

Elemento superiore: initialWindow

Elementi secondari: nessuno

<title>Example Window Title</title>

Specifica se la finestra iniziale dell'applicazione esegue una fusione alfa con il desktop.

Una finestra con trasparenza abilitata potrebbe essere visualizzata più lentamente e richiedere più memoria. L'impostazione della trasparenza non può essere modificata in fase runtime.

Elemento superiore: initialWindow

Elementi secondari: nessuno

<transparent>true</transparent>

Specifica le informazioni della versione per l'applicazione.

La stringa di versione è un indicatore definito dall'applicazione. AIR non è in grado di interpretare in alcun modo la stringa relativa alla versione. Pertanto, la versione “3.0” non viene considerata più aggiornata della versione “2.0”. Esempi: "1.0" , " .4" , " 0.5 ", "4.9" , "1.3.4a" .

In AIR 2.5 e versioni successive, l'elemento version è stato sostituito dagli elementi versionNumber e versionLabel .

Elemento superiore: application

Elementi secondari: nessuno

<version>0.1 Alpha</version>

Specifica una stringa di versione in formato leggibile.

Il valore dell'etichetta di versione viene visualizzato nelle finestre di installazione al posto del valore dell'elemento versionNumber . Se versionLabel non viene utilizzato, versionNumber viene usato per entrambi.

Elemento superiore: application

Elementi secondari: nessuno

<versionLabel>0.9 Beta</versionlabel>

Il numero di versione dell'applicazione.

Elemento superiore: application

Elementi secondari: nessuno

<versionNumber>1.0.657</versionNumber> 
 
<versionNumber>10</versionNumber> 
 
<versionNumber>0.01</versionNumber>

Indica se la finestra iniziale dell'applicazione è visibile non appena viene creata.

Le finestre di AIR, compresa quella iniziale, vengono create come invisibili per impostazione predefinita. Per visualizzare una finestra, chiamate il metodo activate() dell'oggetto NativeWindow o impostate la proprietà visible su true . Potete scegliere di mantenere la finestra principale nascosta inizialmente, in modo che non siano visibili i cambiamenti relativi alla posizione e alle dimensioni della finestra e al layout del relativo contenuto.

Il componente mx:WindowedApplication di Flex visualizza e attiva automaticamente la finestra subito prima dell'invio dell'evento applicationComplete , a meno che l'attributo visible non sia impostato su false nella definizione MXML.

Nei dispositivi del profilo mobile, che non supporta le finestre, l'impostazione visible viene ignorata.

Elemento superiore: initialWindow

Elementi secondari: nessuno

<visible>true</visible>

La larghezza iniziale della finestra principale dell'applicazione.

Se non impostate la larghezza, questa viene determinata dalle impostazioni del file SWF principale oppure, nel caso di un'applicazione AIR basata su HTML, dal sistema operativo.

La larghezza massima di una finestra è cambiata da 2048 pixel a 4096 pixel in AIR 2.

Elemento superiore: initialWindow

Elementi secondari: nessuno

<width>1024</width>

La posizione orizzontale della finestra iniziale dell'applicazione.

Nella maggior parte dei casi è meglio lasciare che sia il sistema operativo a determinare la posizione iniziale della finestra anziché assegnare un valore fisso.

L'origine del sistema di coordinate dello schermo (0,0) è l'angolo superiore sinistro della schermata principale del desktop (determinata dal sistema operativo).

Elemento superiore: initialWindow

Elementi secondari: nessuno

<x>120</x>

La posizione verticale della finestra iniziale dell'applicazione.

Nella maggior parte dei casi è meglio lasciare che sia il sistema operativo a determinare la posizione iniziale della finestra anziché assegnare un valore fisso.

L'origine del sistema di coordinate dello schermo (0,0) è l'angolo superiore sinistro della schermata principale del desktop (determinata dal sistema operativo).

Elemento superiore: initialWindow

Elementi secondari: nessuno

<y>250</y>