-package
komutu ana uygulama dizininden çalıştırılmalıdır. Komut aşağıdaki sözdizimlerini kullanır:
Bileşen uygulama dosyalarından bir AIR paketi oluşturma:
adt -package
AIR_SIGNING_OPTIONS
-target packageType
-sampler
‑hideAneLibSymbols
NATIVE_SIGNING_OPTIONS
output
app_descriptor
FILE_OPTIONS
Bileşen uygulama dosyalarından yerel bir paket oluşturma:
adt -package
AIR_SIGNING_OPTIONS
-target packageType
DEBUGGER_CONNECTION_OPTIONS
-airDownloadURL URL
NATIVE_SIGNING_OPTIONS
output
app_descriptor
-platformsdk path
FILE_OPTIONS
Bileşen uygulama dosyalarından yerel uzantı içeren bir yerel paket oluşturun:
adt -package
AIR_SIGNING_OPTIONS
-migrate MIGRATION_SIGNING_OPTIONS
-target packageType
DEBUGGER_CONNECTION_OPTIONS
-airDownloadURL URL
NATIVE_SIGNING_OPTIONS
output
app_descriptor
-platformsdk path
FILE_OPTIONS
Bir AIR veya AIRI dosyasından yerel paket oluşturma:
adt -package
-target packageType
NATIVE_SIGNING_OPTIONS
output
input_package
Bileşen yerel uzantı dosyalarından yerel bir uzantı paketi oluşturun.
adt -package
AIR_SIGNING_OPTIONS
-target ane
output
ANE_OPTIONS
Not:
ANE dosyasını imzalamanız gerekmez, bu nedenle
AIR_SIGNING_OPTIONS
parametreleri bu örnekte isteğe bağlıdır.
AIR_SIGNING_OPTIONS
AIR imzalama seçenekleri, AIR yükleme dosyasını imzalamak için kullanılmış sertifikayı tanımlar. İmzalama seçenekleri tam olarak
ADT kod imzalama seçenekleri
bölümünde açıklanır.
-migrate
Bu bayrak, uygulamanın
AIR_SIGNING_OPTIONS
parametrelerinde belirtilen sertifikanın yanı sıra bir geçiş sertifikasıyla imzalandığını belirtir. Bu bayrak, yalnızca bir masaüstü uygulamasını yerel yükleyici olarak paketliyorsanız ve uygulama yerel bir uzantı kullanıyorsa geçerlidir. Diğer durumlarda bir hata oluşur. Geçiş sertifikasına yönelik imzalama seçenekleri
MIGRATION_SIGNING_OPTIONS
parametreleri olarak belirtilir. Bu imzalama seçenekleri
ADT kod imzalama seçenekleri
bölümünde tam olarak açıklanır.
-migrate
bayrağını kullanmak, yerel uzantı kullanan bir masaüstü yerel yükleyici uygulaması için güncelleme oluşturmanıza ve uygulamanın kod imzalama sertifikasını değiştirmenize (örn. orijinal sertifikanın süresi dolduğunda) olanak tanır. Daha fazla bilgi için bkz.
Bir AIR uygulamasının güncellenmiş sürümünü imzalama
.
-package
komutunun
-migrate
bayrağı AIR 3.6 ve üst sürümlerinde kullanılabilir.
-target
Oluşturulacak paket türü. Desteklenen paket türleri şunlardır:
-
air — bir AIR paketi. “air” varsayılan değerdir ve AIR veya AIRI dosyaları oluştururken -target bayrağının belirtilmesi gerekmez.
-
airn — genişletilmiş televizyon profilindeki aygıtlar için yerel bir uygulama paketi.
-
ane —bir AIR yerel uzantı paketi
-
Android paketi şunları hedef alır:
-
apk — bir Android paketi. Bu hedefle üretilen bir paket yalnızca bir Android aygıtına yüklenebilir. Taklitçiye yüklenemez.
-
apk‑captive‑runtime — Uygulamayı ve AIR çalışma zamanının sabit bir sürümünü içeren bir Android paketi. Bu hedefle üretilen bir paket yalnızca bir Android aygıtına yüklenebilir. Taklitçiye yüklenemez.
-
apk-debug — ekstra hata ayıklama bilgilerine sahip bir Android paketi. (Uygulamadaki SWF dosyaları da hata ayıklama desteğiyle derlenmelidir.)
-
apk-emulator — hata ayıklama desteği olmayan bir taklitçide kullanmak için Android paketi. (Hem taklitçilerde hem aygıtlarda hata ayıklamaya izin vermek için apk-debug hedefini kullanın.)
-
apk-profile — uygulama performansını ve bellek profilini destekleyen bir Android paketi.
-
iOS paketi şunları hedef alır:
-
ipa-ad-hoc — geçici dağıtım için bir iOS paketi.
-
ipa-app-store — Apple App store dağıtımı için bir iOS paketi.
-
ipa-debug — ekstra hata ayıklama bilgilerine sahip bir iOS paketi. (Uygulamadaki SWF dosyaları da hata ayıklama desteğiyle derlenmelidir.)
-
ipa-test — en iyileştirme veya hata ayıklama bilgisi olmadan derlenen bir iOS paketi.
-
ipa-debug-interpreter — işlevsel olarak hata ayıklama paketine eşittir ancak daha hızlı derler. Ancak, ActionScript bayt kodu yorumlanır ve makine koduna dönüştürülmez. Sonuç olarak, kod yürütme işlemi yorumlayıcı paketinden daha yavaştır.
-
ipa-debug-interpreter-simulator — işlevsel olarak ipa-debug-interpreter seçeneğine eşittir ancak iOS simulator için paketlenir. Yalnızca Macintosh. Bu seçeneği kullanırsanız iOS Simulator SDK'nin yolunu belirterek -platformsdk seçeneğini de dahil etmeniz gerekir.
-
ipa-test-interpreter — işlevsel olarak test paketine eşittir ancak daha hızlı derler. Ancak, ActionScript bayt kodu yorumlanır ve makine koduna dönüştürülmez. Sonuç olarak, kod yürütme işlemi yorumlayıcı paketinden daha yavaştır.
-
ipa-test-interpreter-simulator — işlevsel olarak ipa-test-interpreter seçeneğine eşittir ancak iOS simulator için paketlenir. Yalnızca Macintosh. Bu seçeneği kullanırsanız iOS Simulator SDK'nin yolunu belirterek -platformsdk seçeneğini de dahil etmeniz gerekir.
-
native — yerel bir masaüstü yükleyicisi. Üretilen dosya türü, komutun çalıştırıldığı işletim sisteminin yerel yükleme biçimidir:
Daha fazla bilgi için bkz.
Masaüstü yerel yükleyicisini paketleme
.
-sampler
(yalnızca iOS, AIR 3.4 ve sonraki sürümleri) iOS uygulamalarındaki telemetri tabanlı ActionScript örnekleyicisini etkinleştirir. Bu bayrağın kullanılması, uygulamanın profilini Adobe Scout olarak çıkarmanıza olanak tanır.
Scout
size ActionScript işlev zamanlaması, DisplayList, Stage3D görüntü oluşturma ve daha fazla olanağa yönelik derin bir bakış sunarken, herhangi bir Flash platformu içeriğinin profilini çıkarabilir. Bu bayrağın kullanılmasının performans üzerinde hafif bir etkiye sahip olabileceğini unutmayın ve bu nedenle, üretim uygulamaları için kullanmayın.
-hideAneLibSymbols
(yalnızca iOS, AIR 3.4 ve sonraki sürümleri) Uygulama geliştiricileri, birden çok kaynağa ait birden çok yerel uzantıyı kullanabilir ve ANE'ler ortak bir sembol adını paylaşıyorsa, ADT “nesne dosyasında çoğaltılmış sembol” hatasını verir. Bazı durumlarda bu hata, çalışma zamanında yaşanan çökmeyle görülebilir. ANE kütüphanesinin sembollerinin yalnızca kütüphanenin kaynakları için mi (yes) yoksa global olarak (no) mı görünür yapılıp yapılmayacağını belirtmek üzere
hideAneLibSymbols
seçeneğini kullanabilirsiniz.
-
yes
— İstenmeyen sembol çakışması sorunlarını çözecek şekilde ANE sembollerini gizler.
-
no
— (Varsayılan) ANE sembollerini gizlemez. Bu, AIR 3.4 öncesinde geçerli bir davranıştır.
-embedBitcode
(yalnızca iOS, AIR 25 ve üzeri) Uygulama geliştiricileri evet veya hayır seçeneğini belirterek iOS uygulamalarına bitcode katıştırıp katıştırmayacağını belirlemek üzere
embedBitcode
seçeneğini kullanabilir. Belirtilmemişse, bu anahtarın varsayılan değeri hayır şeklindedir.
DEBUGGER_CONNECTION_OPTIONS
Hata ayıklayıcı bağlantı seçenekleri, bir hata ayıklama paketinin başka bir bilgisayarda çalışan uzak hata ayıklayıcıya bağlanmaya çalışması mı gerektiğini yoksa uzak hata ayıklayıcıdan bir bağlantı dinlemesi mi gerektiğini belirtir. Bu seçenekler kümesi, yalnızca mobil hata ayıklama paketleri (apk-debug ve ipa-debug öğelerini hedef alır) için desteklenir. Bu seçenekler
Hata ayıklayıcı bağlantısı seçenekleri
açıklanmıştır.
- airDownloadURL
Android aygıtlarında AIR çalışma zamanını indirmek ve yüklemek için alternatif bir URL belirtir. Belirtilmemişse ve AIR uygulaması çalışma zamanı zaten yüklü değilse, kullanıcıyı Android Market'taki AIR çalışma zamanına yönlendirir.
Uygulamanız alternatif bir pazar ile dağıtılıyorsa (Google tarafından yönetilen Android Market dışında bir pazar), AIR çalışma zamanını o pazardan indirmek için URL belirtmeniz gerekebilir. Bazı alternatif pazarlar, uygulamaların pazar dışından indirme gerektirmesine izin vermez. Bu seçenek yalnızca Android paketleri için desteklenir.
NATIVE_SIGNING_OPTIONS
Yerel imzalama seçenekleri, yerel bir paket dosyasını imzalamak için kullanılmış sertifikayı tanımlar. Bu imzalama seçenekleri, AIR çalışma zamanı tarafından değil, yerel işletim sistemi tarafından imza uygulamak için kullanılır. Seçenekler bunun dışında AIR_SIGNING_OPTIONS ile aynıdır ve
ADT kod imzalama seçenekleri
bölümünde tam olarak açıklanmıştır.
Yerel imzalar Windows ve Android'de desteklenir. Windows'ta, hem AIR imzalama seçenekleri hem de yerel imzalama seçenekleri belirtilmelidir. Android'de yalnızca yerel imzalama seçenekleri belirtilebilir.
Çoğu durumda, hem AIR imzası hem de yerel imza uygulamak için aynı kod imzalama sertifikasını kullanabilirsiniz. Ancak, bu her durumda geçerli değildir. Örneğin, Google'ın Android Market'a gönderilmiş uygulamalar için geçerli olan ilkesi, tüm uygulamaların en azından 2033 yılına kadar geçerli olan bir sertifika ile imzalanması gerektiğini bildirir. Bu, tanınmış bir sertifika yetkilisi (AIR imzası uygularken önerilir) tarafından verilen sertifikanın bir Android uygulamasını imzalamak için kullanılmaması gerektiği anlamına gelir. (Hiçbir sertifika yetkilisi bu kadar uzun bir geçerlilik süresi olan kod imzalama sertifikası sağlamaz.)
output
Oluşturulacak paket dosyasının adı. Dosya uzantısının belirtilmesi isteğe bağlıdır. Belirtilmezse, -target değerine uygun bir uzantı ve geçerli işletim sistemi eklenir.
app_descriptor
Uygulama tanımlayıcı dosyasının yolu. Yol, geçerli dizine göre veya mutlak yol olarak belirtilebilir. (Uygulama tanımlayıcı dosyası AIR dosyasında
application.xml
olarak yeniden adlandırılır.)
-platformsdk
Hedef aygıt için platform SDK'sinin yolu:
-
Android - AIR 2.6+ SDK, ilgili ADT komutlarını uygulamak için gerekli Android SDK araçlarını içerir. Bu değeri yalnızca Android SDK'nin farklı bir sürümünü kullanmak için ayarlayın. Ayrıca, AIR_ANDROID_SDK_HOME ortam değişkeni zaten ayarlıysa, platform SDK'si yolunun komut satırında sağlanması gerekmez. (Her ikisi de ayarlanmışsa, komut satırında sağlanan yol kullanılır.)
-
iOS - AIR SDK, sabit bir iOS SDK ile paketlenir. -platformsdk seçeneği uygulamaları harici bir SDK ile paketlemenize olanak tanır böylelikle kullanımınız sabit iOS SDK ile sınırlı kalmaz. Örneğin, en son iOS SDK ile bir uzantı oluşturduysanız uygulamanızı paketlerken bu SDK'yi belirtebilirsiniz. Ayrıca iOS Simulator ile ADT'yi kullanırken her zaman iOS Simulator SDK'nin yolunu belirterek -platformsdk seçeneğini dahil etmeniz gerekir.
-arch
Uygulama geliştiriciler bu argümanı kullanarak x86 platformları için APK oluşturabilir; aşağıdaki değerleri alır:
Bir değer belirtilmediğinde armv7 varsayılan değerdir
FILE_OPTIONS
Pakete dahil edilecek uygulama dosyalarını tanımlar. Dosya seçenekleri tam olarak
Dosya ve yol seçenekleri
içinde açıklanmıştır. Bir AIR veya AIRI dosyasından yerel paket oluştururken dosya seçeneklerini belirtmeyin.
input_airi
Bir AIRI dosyasından yerel paket oluştururken belirtin. Hedef
air
ise (veya hedef belirtilmemişse) AIR_SIGNING_OPTIONS öğesi gerekir.
input_air
Bir AIR dosyasından yerel paket oluştururken belirtin. AIR_SIGNING_OPTIONS öğesini belirtmeyin.
ANE_OPTIONS
Yerel bir uzantı paketi oluşturmak için seçenekleri ve dosyaları tanımlar. Uzantı paketi seçenekleri
Yerel uzantı seçenekleri
bölümünde tamamen açıklanmıştır.
ADT -paket komutu örnekleri
SWF tabanlı bir AIR uygulamasının geçerli dizinindeki belirli uygulama dosyalarını paketleyin:
adt –package -storetype pkcs12 -keystore cert.p12 myApp.air myApp.xml myApp.swf components.swc
HTML tabanlı bir AIR uygulamasının geçerli dizinindeki belirli uygulama dosyalarını paketleyin:
adt –package -storetype pkcs12 -keystore cert.p12 myApp.air myApp.xml myApp.html AIRAliases.js image.gif
Geçerli çalışma dizinindeki tüm dosyaları ve alt dizinleri paketleyin:
adt –package -storetype pkcs12 -keystore ../cert.p12 myApp.air myApp.xml .
Not:
Anahtar deposu dosyası, uygulamanızı imzalamak için kullanılan özel anahtarı içerir. İmzalayıcı sertifikasını hiçbir zaman AIR paketine dahil etmeyin. ADT komutunda joker karakterler kullanırsanız, anahtar deposu dosyasını farklı bir konuma yerleştirin, böylece pakete dahil olmaz. Bu örnekte anahtar deposu dosyası cert.p12, üst dizinde bulunur.
Yalnızca ana dosyaları ve bir görüntüler alt dizinini paketleyin:
adt –package -storetype pkcs12 -keystore cert.p12 myApp.air myApp.xml myApp.swf images
HTML tabanlı bir uygulamayı ve HTML, komut dosyaları ve görüntüler alt dizinlerinde bulunan tüm dosyaları paketleyin:
adt –package -storetype pkcs12 -keystore cert.p12 myApp.air myApp.xml index.html AIRALiases.js html scripts images
application.xml dosyasını ve bir çalışma dizininde (release/bin) bulunan ana SWF dosyasını paketleyin:
adt –package -storetype pkcs12 -keystore cert.p12 myApp.air release/bin/myApp.xml –C release/bin myApp.swf
Derleme dosya sisteminizdeki birden fazla yerden alınan varlıkları paketleyin. Bu örnekte uygulama varlıkları paketlemeden önce aşağıdaki klasörlerde konumlandırılmıştır:
/devRoot
/myApp
/release
/bin
myApp-app.xml
myApp.swf or myApp.html
/artwork
/myApp
/images
image-1.png
...
image-n.png
/libraries
/release
/libs
lib-1.swf
lib-2.swf
lib-a.js
AIRAliases.js
Aşağıdaki ADT komutunu /devRoot/myApp dizininden çalıştırma:
adt –package -storetype pkcs12 -keystore cert.p12 myApp.air release/bin/myApp-app.xml
–C release/bin myApp.swf (or myApp.html)
–C ../artwork/myApp images
–C ../libraries/release libs
Şu paket yapısıyla sonuçlanır:
/myAppRoot
/META-INF
/AIR
application.xml
hash
myApp.swf or myApp.html
mimetype
/images
image-1.png
...
image-n.png
/libs
lib-1.swf
lib-2.swf
lib-a.js
AIRAliases.js
ADT’yi basit bir SWF tabanlı uygulama için Java programı olarak çalıştırın (sınıf yolunu ayarlamadan):
java –jar {AIRSDK}/lib/ADT.jar –package -storetype pkcs12 -keystore cert.p12 myApp.air myApp.xml myApp.swf
ADT’yi basit bir HTML tabanlı uygulama için Java programı olarak çalıştırın (sınıf yolunu ayarlamadan):
java –jar {AIRSDK}/lib/ADT.jar –package -storetype pkcs12 -keystore cert.p12 myApp.air myApp.xml myApp.html AIRAliases.js
ADT’yi bir Java programı olarak çalıştırın (Java sınıf yolu ADT.jar paketini içerecek şekilde ayarlanmış olarak):
java -com.adobe.air.ADT –package -storetype pkcs12 -keystore cert.p12 myApp.air myApp.xml myApp.swf
ADT'yi Apache Ant'de bir Java görevi olarak çalıştırın (ancak, ADT komutunun doğrudan Ant komut dosyalarında kullanılması genellikle en iyi yöntemdir). Örnekte gösterilen yollar Windows içindir:
<property name="SDK_HOME" value="C:/AIRSDK"/>
<property name="ADT.JAR" value="${SDK_HOME}/lib/adt.jar"/>
target name="package">
<java jar="${ADT.JAR}" fork="true" failonerror="true">
<arg value="-package"/>
<arg value="-storetype"/>
<arg value="pkcs12"/>
<arg value="-keystore"/>
<arg value="../../ExampleCert.p12"/>
<arg value="myApp.air"/>
<arg value="myApp-app.xml"/>
<arg value="myApp.swf"/>
<arg value="icons/*.png"/>
</java>
</target>
Not:
Bazı bilgisayar sistemlerinde, dosya sistemi yollarındaki çift baytlık karakterler yanlış yorumlanabilir. Bu durum oluşursa, ADT'yi çalıştırmak için kullanılan JRE'yi UTF-8 karakter setini kullanacak şekilde ayarlamayı deneyin. Bu, ADT'yi Mac ve Linux'ta başlatmak için kullanılan komut dosyasında varsayılan olarak gerçekleştirilir. Windows adt.bat dosyasında veya ADT'yi doğrudan Java'dan çalıştırdığınızda, Java komut satırında
‑Dfile.encoding=UTF-8
seçeneğini belirtin.