概述
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{ @Override public FREContext createContext(String pType) { return new SkyContext(); } @Override public void dispose() {} @Override public void initialize() {} }
public class SkyContext extends FREContext{ @Override public void dispose() {} @Override public Map<String, FREFunction> getFunctions() { HashMap<String, FREFunction> map = new HashMap<String, FREFunction>(); map.put("keyA", new TestToastFunction()); //可继续put其他function return map; } }
public class TestToastFunction implements FREFunction{ @Override public 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:签名文件
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); } } }
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