Android开发 Flash Ane创建和使用

Adobe AIR Native Extension，Adobe AIR的本地扩展，简称ANE。本来已经是过时的技术了，但是由于项目需求，需要使用 flash ane，在一番挣扎之后总算是成功编写了 ane 并且实现了需要的功能，这里记录下来，以免这种古老的技术流失。

由于工作保密性，这里只以一个简单例子来呈现flash ane的编写和使用。

一、创建 Android 本地程序 jar 包

1.创建android工程

首先是开发工具，我们需要用到的工具是 Flash Builder 和 Eclipse 。

这里推荐使用Eclipse来创建Android工程，因为使用Android Studio创建工程，最后在导出jar包等地方会有问题。至于Eclipse怎么配置Android开发环境，请自行百度，教程很多。不过在配置Android开发环境时，会因为网上Android SDK的版本不够老（因为新的SDK已经不支持Eclipse了，google很任性~），导致环境配置失败。如需老的SDK，可以在下方留言。

我们先在Eclipse中创建一个名为 HelloAne 的Android工程，并且不创建Activity和launcher icon:

 

 接下来导入FlashRuntimeExtensions.jar。该jar包可以在Flash Builder的安装路径下找到：..\Adobe Flash Builder 4.7 (64 Bit)\sdks\4.6.0\lib\android 。找到后，将jar包拷贝到新建的Android工程的 ..\HelloAne\libs 路径下。操作完的文件目录结构如下：

接下来实现 FREExtension （Implements）、FREContext （extends）和 FREFunction (Implements)。

2.创建Function

我们创建一个 ToastFunction 的类，并且指定包名是：com.helloapp.ane.function。然后编写如下代码：

package com.helloapp.ane.function;

import com.adobe.fre.FREContext;
import com.adobe.fre.FREFunction;
import com.adobe.fre.FREInvalidObjectException;
import com.adobe.fre.FREObject;
import com.adobe.fre.FRETypeMismatchException;
import com.adobe.fre.FREWrongThreadException;

import android.widget.Toast;

public class ToastFunction implements FREFunction {

	@Override
	public FREObject call(FREContext context, FREObject[] objectAry) {
		// TODO Auto-generated method stub
		FREObject result = null;
		try {
			
			String msg = objectAry[0].getAsString();
			Toast.makeText(context.getActivity(), msg, Toast.LENGTH_SHORT).show();
			
			// 返回值
			result = FREObject.newObject(msg);
		} catch (IllegalStateException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		} catch (FRETypeMismatchException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		} catch (FREInvalidObjectException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		} catch (FREWrongThreadException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
		
		return result;
	}

}

call方法是最终调用到Android native的地方，第一个参数context是Android native的接口类对象，第二个参数objectAry是从Flex手机项目（AS3）传过来的参数数组。例子中接收了一个String类型的msg参数，并显示在手机上。如果需要返回值，可以通过

result = FREObject.newObject(msg);

设置返回值并返回给Flex项目。

创建NativeContext

我们在包路径：com.helloapp.ane.context;下创建一个名为 HelloAppContext的java 类，目的是返回一个存放本地方法的Map。具体代码如下：

package com.helloapp.ane.context;

import java.util.HashMap;
import java.util.Map;

import com.adobe.fre.FREContext;
import com.adobe.fre.FREFunction;
import com.helloapp.ane.function.ToastFunction;

public class HelloAppContext extends FREContext {
	
	private static final String TOAST_FUNC_KEY = "toast";

	@Override
	public void dispose() {
		// TODO Auto-generated method stub
		
	}

	@Override
	public Map<String, FREFunction> getFunctions() {
		// TODO Auto-generated method stub
		Map<String,FREFunction> functions = new HashMap<String, FREFunction>();
		functions.put(TOAST_FUNC_KEY, new ToastFunction());
		return functions;
	}

}

创建NativeExtension

在包路径：com.helloapp.ane.extension;下创建名为 HelloAppExtension 的java类，该类负责与AS3 交互。具体代码如下：

package com.helloapp.ane.extension;

import com.adobe.fre.FREContext;
import com.adobe.fre.FREExtension;
import com.helloapp.ane.context.HelloAppContext;

public class HelloAppExtension implements FREExtension {

	@Override
	public FREContext createContext(String arg0) {
		// TODO Auto-generated method stub
		return new HelloAppContext();
	}

	@Override
	public void dispose() {
		// TODO Auto-generated method stub
		
	}

	@Override
	public void initialize() {
		// TODO Auto-generated method stub
		
	}

}

这样，我们的Android Native Lib就完成了。

导出 jar 包

鼠标选中src文件夹，右键——>Export——>Java——>JAR file——>Next：

设置jar包导出的路径和名称，然后点击Finish即可导出jar包。

 

二、创建AS3 Lib

1.创建Flex库项目

打开FlashBuilder，文件——>新建——>Flex 项目

2.创建AS类

src目录，右键——>新建——>ActionScript类

3.实现接口类

通过ExtensionContext与Native交互。

com.example.myextension是一会新建extension.xml中要定义的一个ID，代表了android native extension，通过这个id得到extension的Context，之后调用call方法调用到Native层的Function，根据function_key找到对应的Function。
例如“toast”对应我们之前在android工程里定义的ToastFunction。

package com.example.helloane
{
	import flash.external.ExtensionContext;
	
	public class AndroidToast
	{
		public var extCtx:ExtensionContext=null;
		
		public function AndroidToast()
		{
			extCtx = ExtensionContext.createExtensionContext("com.example.myextension","");
		}
		
		public function showToast(msg:String):void{
			if(extCtx){
				extCtx.call("toast",msg);
			}
		}

	}
}

4.创建extension.xml

在HelloAneFlex工程根目录下创建一个名为extension.xml的文件

并编辑如下：

<?xml version="1.0" encoding="UTF-8"?>
<extension xmlns="http://ns.adobe.com/air/extension/3.1">
    <id>com.example.myextension</id>
    <versionNumber>1</versionNumber>
    <platforms>
        <platform name="Android-ARM">
            <applicationDeployment>
                <nativeLibrary>helloappane.jar</nativeLibrary>
                <initializer>com.helloapp.ane.extension.HelloAppExtension</initializer>
                <finalizer>com.example.helloane.AndroidToast</finalizer>
            </applicationDeployment>
        </platform>
    </platforms>
</extension>

编辑id：com.example.myextension 和AS类里面使用的id一样，实际上，是AS类使用的ID必须和这里一样

编辑nativeLibrary:最早导出的jar包：helloappane.jar

编辑initializer：在Android代码中实现的Extension类的全称：com.helloapp.ane.extension.HelloAppExtension

编辑finalizer：在Flex库工程中实现的接口类的全称：com.example.helloane.AndroidToast

5.设置打包目录

创建一个文件夹makeane，把HelloAneFlex工程下的extension.xml文件和bin目录下的HelloAneFlex.swc拷贝进去。再在makeane文件夹下新建一个名为Android-ARM的文件夹，首先把之前打好的helloappane.jar拷贝到Android-ARM文件夹下，再把HelloAneFlex.swc拷贝出一个副本并重命名为zip压缩文件（或者其他压缩文件），解压之后，将里面的所有文件拷贝到Android-ARM文件夹下。这样我们就准备好了打包的所有文件：

6.打包生成ane

进入到makeane文件夹下，shift+右键，选择“在此处打开命令窗口”进入到cmd界面。然后输入以下命令：

"E:\软件\AdobeFlashBuilder\Adobe Flash Builder 4.7 (64 Bit)\sdks\4.6.0\bin\adt" -package -target ane helloappane.ane extension.xml -swc *.swc -platform Android-ARM -C Android-ARM .

 其中双引号里是Flash Builder下的adt的路径，注意改成自己的adt的路径！

命令执行完，我们就能在当前文件夹下找到新生成的ANE：helloappane.ane

注意：

有文档说要设置Action Script库编译器参数如下，所以最好设置一下：