ANE 在 Android(安卓)上的应用

概述

Adobe Air是利用Adobe公司的Flash技术开发的媒体播放平台。而Native Extension就是让AIR可以调用各个平台上的本地代码(native code, 如ios上的object-c，android上的java，desktop上的c++，c#等)，从而完成对AIR中Actionscript API的自定义扩展。即可以让开发者通过编写基于平台的本地代码扩展ActionScript。从而完成一些原有Actionscript无法完成的功能。

Native Extension结构及原理

一个NativeExtension项目主要有两个部分组成：As 端的库项目和底层代码的实现项目。
下图是Android 上整个NativeExtension项目的体系结构。

AS库项目部分

ExtensionContext是其核心类，负责与Java代码的交互。ExtensionContext需要调用createExtensionContext方法创建和初始化Java端的本地代码。而是用call方法可以调用具体的Java代码并获得返回结果。同时Extension还会接受从java代码抛出的事件。

本地java项目部分

关键类 FREContext
关键接口 FREExtension、FREFunction

FREExtension是java端自定义代码的入口，需要重写createContext方法从而获得本地代码的上下文，即自己扩展的FREContext子类。
FREFunction是本地方法的具体实现，实例化后以键值对的形式存入FREContext，从而在AS端的ExtensionContext中调用的call方法中传入对应键值调起本地方法。

开发流程

项目分成三部分：Android项目，Flex Library库项目和Flex Mobile项目

Android项目

1、在Eclipse中新建Android项目，不必勾选创建Activity

2、将项目的类型设为Library型
properties -> Android -> 勾选 Is Libirary

3、导入Ane android jar包(FlashRuntimeExtensions.jar)

4、添加java本地实现

public class SkyExtension implements FREExtension{@Overridepublic FREContext createContext(String pType) {return new SkyContext();}@Overridepublic void dispose() {}@Overridepublic void initialize() {}}

public class SkyContext extends FREContext{@Overridepublic void dispose() {}@Overridepublic Map<String, FREFunction> getFunctions() {HashMap<String, FREFunction> map = new HashMap<String, FREFunction>();map.put("keyA", new TestToastFunction());//可继续put其他functionreturn map;}}

public class TestToastFunction implements FREFunction{@Overridepublic FREObject call(FREContext context, FREObject[] params) {Toast.makeText(context.getActivity(), "测试成功：android本地被调用", Toast.LENGTH_LONG).show();FREObject result=null;try {result = FREObject.newObject("这是可返回的值");} catch (Exception e) {e.printStackTrace();}return result;}}

5、导出jar包（AneTestNative.jar）

Flex Library库项目

1、新建Flex Library项目，注意指定AIR3的SDK，并且勾选“包括Adobe AIR库”
2、在src下新建包，并添加as代码

package com.linxcool.test{    import flash.external.ExtensionContext;    public class HelloWorldExtension    {        public static const KEY:String = "keyA";//与java端中Map里的key一致        public static const EXTENSION_ID:String = "extTest";//与extension.xml中的id标签一致        private var extContext:ExtensionContext;        public function HelloWorldExtension()        {            //第二个为参数，会传入java代码中的FREExtension的createContext方法            extContext = ExtensionContext.createExtensionContext(EXTENSION_ID,"");        }        public function hello(name:String):String{            if(extContext){                return extContext.call(KEY,name) as String;            }            return "call failed";        }    }}

3、在src下新建名为extension.xml的文件

<?xml version="1.0" encoding="UTF-8"?><extension xmlns="http://ns.adobe.com/air/extension/2.5"><id>extTest</id><versionNumber>1</versionNumber><platforms><platform name="Android-ARM"><applicationDeployment>    <!--即为Android本地导出的jar包名-->    <nativeLibrary>AneTestNative.jar</nativeLibrary>    <!--即为Android本地FREExtension全路径-->    <initializer>com.linxcool.test.SkyExtension</initializer>    <finalizer>com.linxcool.test.SkyExtension</finalizer></applicationDeployment>     </platform></platforms></extension>

4、生成ANE文件

随便新建一个目录作为工作目录（AneBuild），并为其建立子文件夹Android-ARM
将Flex Library项目中自动生成的.swc文件和extension.xml复制到AneBuild目录下
以ZIP方式解压.swc文件获取catalog.xml和library.swf文件并存到Android-ARM文件夹下
拷贝AneTestNative.jar到Android-ARM文件夹下
拷贝自己的签名文件.p12到AneBuild文件夹下

最终结果
AneBuild：Android-ARM文件夹、.swc文件、extension.xml、.p12文件
Android-ARM：catalog.xml、library.swf、AneTestNative.jar

使用命令提示符进入到AneBuild文件目录下，使用adt命令对上述文件打包

"D:\develop\Adobe\Adobe Flash Builder 4.5\sdks\4.5.0-air3.0\bin\adt" -package -storetype PKCS12 -keystore linxcool.p12 -storepass 08002615 -target ane aneTest.ane extension.xml -swc *.swc -platform Android-ARM -C Android-ARM .

linxcool.p12：签名文件
08002615：签名密码
aneTest.ane：生成的ANE文件名

Flex Mobile项目

1、新建Flex Mobile项目
2、添加本地扩展添加上面所生成的ane包
3、编辑 app-xml文件添加android中所需的权限
4、调用Ane中的函数即可

附加

发现很多人在ANE打包过程中会有很多问题，我补充总结下：

1、若需要返回android端返回的数据

android端调用以下方法返回数据：FREContext.dispatchStatusEventAsync(标识, 内容);

flash 注册监听返回返回的数据：ExtensionContext.addEventListener(StatusEvent.STATUS,onStatus);

2、生成的APK资源ID无法引用

注意布局文件需要文字国际化。

将android端需要的资源文件拷贝到上诉的Android-ARM文件夹下。

并在android的代码中映射ID关系，在调用界面前调用如下代码：

public static void setResourctID(String rName,FREContext context) throws Exception{Class<?> R = Class.forName(rName);Class<?>[] clss = R.getDeclaredClasses();for (int i = 0; i < clss.length; i++) {Class<?> cls = clss[i];Field[] flds = cls.getDeclaredFields();for (int j = 0; j < flds.length; j++) {Field fld = flds[j];fld.setAccessible(true);Object obj = cls.newInstance();String name = cls.getSimpleName()+"."+fld.getName();int id = context.getResourceId(name);fld.set(obj, id);}}}

其中rName为android生成R.java文件的全类名(如com.linxcool.air.R)，打包时请打入。

3、assets资源、.so文件问题

最简单的方式，生成的apk包解压，拷贝assets文件及so文件到APK包的对应目录下，重新打包签名即可。

4、FlashBuilder工程中引用ANE时报错（扩展XML文件无效或不存在）

不用理会。

5、打包的时候出现 Invalid swc file The extension NameSpace requires to SWF version to be 13 or lower

在AS库项目中右键属性 -> flex库编译器 ->附加库编译器参数修改为-locale en_US -swf-version=13

更多相关文章

随机推荐