Opcje plików i ścieżek

Opcje plików i ścieżek określają wszystkie pliki, które wchodzą w skład pakietu. Dla opcji plików i ścieżek jest stosowana następująca składnia: 

files_and_dirs -C dir files_and_dirs -e file_or_dir dir -extdir dir

files_and_dirs Pliki i katalogi, które będą pakowane w pliku AIR. Możliwe jest określenie dowolnej liczby plików i katalogów — poszczególne nazwy należy rozdzielać znakiem spacji. Po umieszczeniu na liście katalogu do pakietu zostaną dodane wszystkie jego pliki i podkatalogi, oprócz plików ukrytych. (Jeśli ponadto określono plik deskryptora aplikacji bezpośrednio, za pomocą znaku wieloznacznego lub rozszerzenia katalogu, ten plik zostanie zignorowany i nie zostanie dodany do pakietu po raz drugi). Wybrane pliki i katalogi muszą znajdować się w bieżącym katalogu lub w jednym z jego podkatalogów. W celu zmiany bieżącego katalogu należy użyć opcji -C .

Ważne: Znaki wieloznaczne nie mogą być używane w argumentach file_or_dir za opcją – C . (Powłoki poleceń rozszerzają znaki wieloznaczne przed wprowadzeniem argumentów do narzędzia ADT, co sprawia, że narzędzie ADT poszukuje plików w błędnej lokalizacji). Zamiast nazwy katalogu bieżącego można użyć znaku „.”. Na przykład polecenie: -C assets . powoduje skopiowanie całej zawartości katalogu assets, łącznie z jego podkatalogami, do głównego poziomu pakietu aplikacji.

Argument -C katalog pliki_i_katalogi zmienia katalog roboczy na wartość katalog przed rozpoczęciem przetwarzania kolejnych plików i katalogów dodawanych do pakietu aplikacji (określonych w lokalizacji pliki_i_katalogi ). Pliki i katalogi są dodawane do katalogu głównego pakietu aplikacji. Opcja – C może być używana dowolną ilość razy w celu uwzględnienia plików z wielu punktów w systemie plików. Jeśli dir określa ścieżkę względną, ścieżka jest odczytywana zawsze względem oryginalnego katalogu roboczego.

W miarę przetwarzania przez narzędzie ADT plików i katalogów zawartych w pakiecie następuje zapisywanie względnych ścieżek między katalogiem bieżącym a plikami docelowymi. Podczas instalowania aplikacji te ścieżki są rozwijane do struktury katalogu aplikacji. Dlatego polecenie -C release/bin lib/feature.swf powoduje umieszczenie pliku release/bin/lib/feature.swf w podkatalogu lib głównego folderu aplikacji.

-e file_or_dir dir Powoduje umieszczenie pliku lub katalogu w określonym katalogu pakietu. Tej opcji nie można stosować podczas pakowania pliku ANE.

Uwaga: Element <content> pliku deskryptora aplikacji musi określać końcową lokalizację głównego pliku aplikacji w drzewie katalogów pakietu aplikacji.

-extdir dir Wartość parametru dir jest nazwą katalogu, w którym mają być wyszukiwane rozszerzenia natywne (pliki ANE). Należy podać ścieżkę bezwzględną lub określić ścieżkę względem katalogu bieżącego. Opcję -extdir można określić wielokrotnie.

Podany katalog zawiera pliki ANE dla rozszerzeń natywnych używanych przez aplikację. Każdy plik ANE w tym katalogu ma rozszerzenie nazwy pliku ane. Nazwa pliku przed rozszerzeniem nazwy pliku ane nie musi być jednak zgodna z wartością elementu extensionID w pliku deskryptora aplikacji.

Jeśli na przykład jest używana opcja -extdir ./extensions , katalog extensions może mieć strukturę podobną do następującej: 

extensions/ 
    extension1.ane 
    extension2.ane
Uwaga: Zastosowania opcji -extdir są różne w narzędziach ADT i ADL. W narzędziu ADL opcja ta określa katalog zawierający podkatalogi, z których każdy zawiera rozpakowany plik ANE. W narzędziu ADT opcja ta określa katalog zawierający pliki ANE.