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项目的体系结构。

ANE 在 Android 上的应用_第1张图片

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:签名文件
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


你可能感兴趣的:(android,Flex,Adobe,actionscript,extension)