[ios][air] AIR面向IOS設備的原生擴展

ANE組成部分

---

在IOS平台中，ANE的組成部分基本分為AS 3.0擴展類庫和Obj-C原生擴展類庫兩個部分，這兩個部分打包后生成AIR擴展文件(.ane)，最后和.swf起打包成IOS原生應用IPA文件。

 

Action Script類庫構建

---

ANE的AS擴展部分是一個SWC，AIR 3.0 SDK里為flash.external.ExtensionContext類添加了新的方法,這里類名為NativeAlert.

1) 開發環境, Adobe AIR 3.0\3.1 SDK, Flash Builder或Flash Develop.

2) 建立Flex 庫項目，編譯的時候包括AIR庫，鏈接方式設定為默認的外部鏈接.

3) 主要類NativeAlert與NativeAlertEvent.

4) 最終得到NativeAlert.swc

NativeAlert中主要工作:

• 定義擴展唯一ID;
• 通過指定ID，初始化上下文環境,獲取實例；
• 根據ane中導出的方法名encodeBMP調用原生類中定義的方法decode，參數為ByteArray和int,int；

package com.wanghui.nativeextensions
{
    import flash.external.ExtensionContext;
    import flash.utils.ByteArray;

    public class ImageProcessor
    {
        private var context:ExtensionContext;

        public function ImageProcessor()
        {
            context = ExtensionContext.createExtensionContext('com.wanghui.nativeextensions.myextension', ''); //@Attention[1]
        }
        public function decode(data:ByteArray)
        {
             var byteArray:ByteArray = data;
             var transparent:int     = byteArray.readUnsignedByte();
             // 調用原生類的decode方法
             var handler:int         = int(context.call("decode",byteArray,byteArray.position,transparent)); //@Attention[2]
        }
    }
}

ExtensionContext通過靜態方法createExtensionContext()來獲得一個實例，參數com.wanghui.nativeextensions.myextension是這個擴展的ID，它非常重要，在擴展的配置文件里和應用程序描述文件中都需要用這個ID進行配對。

調用原生類中定義的方法可以用方法call()來實現，由於是同步調用，所以函數可以有返回值。還可以給ExtensionContext類添加事件偵聽，用來獲取從原生類中派發回來的事件。

Obj-C本地擴展

---

1)開發環境XCode

2) 建立Cocoa Touch Static Library;

3) 選擇build settings，選中 Preprocessor Macros,移除所有標記，諸如DEBUG=1 and ${inherited};

4) 選擇build settings，設定Enable linking with shared libraries為YES;

5) 引入AIR SDK中的頭文件FlashRuntimeExtensions.h;

6) 原生類中導出方法decode

7) 最終得到decoder.a

decode方法定義為返回FREObject方法，FREObject是接口類型，參數類型如下。這里要注意，與AS的接口包括函數返回值，都要定義成FREObject類型，比如代碼中的handlerObject。

// ctx為上下文id，argc為參數個數，argv中為參數信息
FREObject decode(FREContext ctx, void* funcData, uint32_t argc, FREObject argv[])
{
    FREByteArray byteArray;
    int position,transparent;
    // 獲取參數信息
    FREAcquireByteArray(argv[0],&byteArray);
    FREGetObjectAsUint32(argv[1],(uint32_t*)&position);
    FREGetObjectAsUint32(argv[2],(uint32_t*)&transparent);
    Handler *handler=malloc(sizeof(Handler));

    // Acquir之后進行Release
    FREReleaseByteArray(argv[0]);
    FREObject handlerObject;
    // 申請返回數據空間
    FRENewObjectFromUint32((uint32_t)handler,&handlerObject);
    return handlerObject;
}

要將decode方法定義為接口方法，需在ContextInitializer進行導出，指定導出的方法數，方法名稱:

void ContextInitializer(void* extData, const uint8_t* ctxType, FREContext ctx,
        uint32_t* numFunctionsToTest, const FRENamedFunction** functionsToSet){
    initTables();
    //定義的接口的數量
    *numFunctionsToTest = 1;
    //定義一個FRENamedFunction類型的實例func，初始化函數的個數
    FRENamedFunction* func = (FRENamedFunction*) malloc(sizeof(FRENamedFunction) * 1);
    //定義一個接口，name是字符串"decode";，函數體是decode
    func[0].name = (const uint8_t*) "decode";
    func[0].functionData = NULL;
    func[0].function = &decode;
    *functionsToSet = func;
}

ContextInitializer方法是在原生擴展類的初始化函數ExtInitializer中指定的:

void ExtInitializer(void** extDataToSet,FREContextInitializer* ctxInitializerToSet,FREContextFinalizer* ctxFinalizerToSet){
    *extDataToSet = NULL;
    *ctxInitializerToSet = &ContextInitializer;
    *ctxFinalizerToSet = &ContextFinalizer;
}

ExtInitializer是原生擴展的程序入口，它可以通過擴展配置文件extension.xml來定義:

<extension xmlns="http://ns.adobe.com/air/extension/2.5">
    <id>com.wanghui.nativeextensions.myextension</id>          <!--@ Attention [3]擴展ID>
    <versionNumber>0.0.1</versionNumber>
    <platforms>
        <platform name="iPhone-ARM">
            <applicationDeployment>
                <nativeLibrary>decoder.a</nativeLibrary>       <!--@ Attention [4]本地擴展庫名稱>
                <initializer>ExtInitializer</initializer>
                <finalizer>ExtFinalizer</finalizer>
            </applicationDeployment>
        </platform>

打包ANE

---

1) decoder.a

2) NativeAlert.swc

3) NativeAlert.swc解壓得到的library.swf

4) 擴展描述文件extension.xml

5) 利用AIR提供的adt打包,得到decoder.ane

adt -package  -target ane decoder.ane extension.xml -swc NativeAlert.swc -platform iPhone-ARM library.swf decoder.a

打包IPA

---

1) 寫測試程序(flex手機項目)，使用類庫NativeAlert.swc，選擇外部鏈接swc的方式,得到testmobile.swf;應用程序描述文件testmobile-app.xml,添加如下描述:

<extensions>
<!--@ Attention [5]擴展ID>
<extensionID> com.wanghui.nativeextensions.myextension </extensionID>
</extensions>

1) decoder.ane,存放在ext目錄下

2) 開發者設備授權文件 ceshi.mobileprovision

3) 開發者簽名證書文件developerkey.p12

4) 打包ipa得到example.ipa

/adt -package -target ipa-test-interpreter -provisioning-profile ceshi.mobileprovision -storetype pkcs12 -keystore developerkey.p12 -storepass 1234 example.ipa testmobile-app.xml testmobile.swf -extdir ext

注:

---

1) @ Attention[1] [3] [5]位置的擴展ID一定要一致；

2) 模擬器中無法運行，調試可以選擇輸出調試信息的方式；

3) 運行程序后如果白屏立刻退出，確定[Obj-C本地擴展部分的] 3)4)兩項設置是正確的；