Korzystanie z rozszerzeń natywnych dla środowiska Adobe AIR

Programiści rozszerzeń natywnych umieszczają rozszerzenia natywne w plikach ANE. Plik ANE jest plikiem archiwum zawierającym wszystkie niezbędne biblioteki i zasoby dla rozszerzenia natywnego.

W przypadku niektórych urządzeń plik ANE zawiera bibliotekę kodu natywnego używaną przez rozszerzenie natywne. Natomiast w przypadku innych urządzeń biblioteka kodu natywnego jest zainstalowana na urządzeniu. Czasami rozszerzenie natywne w ogóle nie zawiera kodu natywnego dla określonego urządzenia, lecz jest zaimplementowane wyłącznie przy użyciu kodu ActionScript.

Programista aplikacji AIR używa pliku ANE w następujący sposób:

Język ActionScript 3.0 udostępnia klasę NativeProcess. Ta klasa umożliwia aplikacji AIR uruchamianie procesów natywnych w systemie operacyjnym komputera. Ta możliwość jest podobna do działania rozszerzeń natywnych, które zapewniają dostęp do funkcji i bibliotek specyficznych dla platformy. Podejmując decyzję o użyciu klasy NativeProcess lub rozszerzenia natywnego, należy rozważyć następujące kwestie:

• Tylko profil AIR extendedDesktop obsługuje klasę NativeProcess. Dlatego w aplikacjach korzystających z profilów AIR mobileDevice i extendedMobileDevice można stosować tylko rozszerzenia natywne.

• Programiści rozszerzeń natywnych często dostarczają implementacje natywne dla różnych platform, ale oferowany przez nich interfejs API języka ActionScript jest zazwyczaj taki sam na wszystkich platformach. Jeśli jest używana klasa NativeProcess, kod ActionScript do uruchamiania procesu natywnego może mieć różną postać na poszczególnych platformach.

• Klasa NativeProcess uruchamia osobny proces, natomiast rozszerzenie natywne działa w tym samym procesie co aplikacja AIR. Dlatego w przypadku obaw dotyczących awarii kodu użycie klasy NativeProcess jest bezpieczniejsze. Jednak stosowanie osobnego procesu może wymagać zaimplementowania obsługi komunikacji między procesami.

Plik SWC to biblioteka klas ActionScript formacie archiwum. Zawiera on plik SWF i inne pliki zasobów. Przy użyciu pliku SWC można wygodnie udostępnić klasy ActionScript zamiast poszczególnych plików kodu ActionScript i zasobów.

Pakiet rozszerzenia natywnego jest plikiem ANE. Podobnie jak plik SWC, plik ANE również jest biblioteką klas ActionScript zawierającą plik SWF i inne pliki w formacie archiwum. Najważniejszą różnicą między plikami ANE i SWC jest to, że tylko plik ANE może zawierać bibliotekę kodu natywnego.

Począwszy od środowiska AIR 3, można korzystać z rozszerzeń natywnych w aplikacjach dla następujących urządzeń:

W wielu przypadkach to samo rozszerzenie natywne jest przeznaczone dla kilku platform. Plik ANE rozszerzenia zawiera kod ActionScript i biblioteki natywne dla każdej obsługiwanej platformy. Zazwyczaj biblioteki ActionScript mają takie same interfejsy publiczne dla wszystkich tych platform. Biblioteki natywne z konieczności różnią się.

Czasami rozszerzenie natywne obsługuje platformę domyślną. Implementacja dla platformy domyślnej zawiera tylko kod ActionScript, bez kodu natywnego. Jeśli zostanie utworzony pakiet z aplikacją dla platformy nieobsługiwanej przez dane rozszerzenie, podczas uruchamiania aplikacji będzie używana implementacja domyślna. Rozszerzenie może na przykład udostępniać funkcję dotyczącą tylko urządzeń przenośnych. Takie rozszerzenie może również oferować domyślną implementację pozwalającą symulować tę funkcję w aplikacji dla komputerów.

Następujące profile środowiska AIR obsługują rozszerzenia natywne:

Aby korzystać z rozszerzenia natywnego w aplikacji, wykonaj następujące zadania:

1. Zadeklaruj rozszerzenie w pliku deskryptora aplikacji.

2. Umieść plik ANE w ścieżce biblioteki aplikacji.

3. Spakuj aplikację.

Wszystkie aplikacje AIR mają plik deskryptora aplikacji. Gdy aplikacja korzysta z rozszerzenia natywnego, plik deskryptora aplikacji zawiera element <extensions> . Na przykład:

<extensions> 
    <extensionID>com.example.Extension1</extensionID> 
    <extensionID>com.example.Extension2</extensionID> 
</extensions>

Element extensionID ma wartość taką samą jak element id w pliku deskryptora rozszerzenia. Plik deskryptora rozszerzenia jest plikiem XML o nazwie extension.xml. Jest on spakowany w pliku ANE. Plik extension.xml można wyświetlić za pomocą narzędzia do wyodrębniania archiwum.

Aby skompilować aplikację korzystającą z rozszerzenia natywnego, należy umieścić plik ANE w ścieżce biblioteki.

Za pomocą narzędzia ADT spakuj aplikację korzystającą z rozszerzeń natywnych. Nie można spakować aplikacji za pomocą programu Flash Professional CS5.5 lub Flash Builder 4.5.1.

Szczegółowe informacje o korzystaniu z narzędzia ADT znajdują się na stronie Narzędzie ADT .

Na przykład poniższe polecenie narzędzia ADT powoduje utworzenie pliku DMG (pliku instalatora natywnego dla systemu Mac OS X) dla aplikacji korzystającej z rozszerzeń natywnych:

adt -package 
    -storetype pkcs12 
    -keystore myCert.pfx 
    -target native 
    myApp.dmg 
    application.xml 
    index.html resources 
    -extdir extensionsDir

adt -package 
    -target apk 
    -storetype pkcs12 -keystore ../codesign.p12 
    myApp.apk 
    myApp-app.xml 
    myApp.swf icons 
    -extdir extensionsDir

Następujące polecenie powoduje utworzenie pakietu systemu iOS dla aplikacji przeznaczonej dla telefonu iPhone:

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 
    -extdir extensionsDir

Należy zwrócić uwagę na następujące kwestie:

• Należy użyć typu pakietu instalatora natywnego.

• Należy określić katalog rozszerzeń.

• Należy upewnić się, że plik ANE obsługuje urządzenie docelowe aplikacji.