在 FlashDevelop 的移动项目 (Adobe AIR) 中使用 ane

现在手机项目开发市场异常繁荣,各种技术层出不穷,作为一名跟随 Flash 多年的屌丝前端程序猿来说,Adobe Air 技术让我们看到一丝曙光(可以说很大一束 XDD ),而且在游戏领域已经有很多成功案例,效果丝毫不亚于原生语言开发的应用.

但是,再好的技术也有其不足之处,目前来说 Air 提供的对移动设备底层功能支持还比较有限,很多 IOS/Android 公共功能都不支持. 好在 Adobe 提供了很好的解决方案,那就是 ane (AIR?Native Extensions),他为设备与 Air 之间的沟通起到了很好的桥梁作用.

下面简单介绍下在 FlashDevelop (以下简称 FD)中创建和发布包含 ane 的移动项目的一些注意事项:

当然首先你要有必要的 ane 文件,下面这个地址描述了如何创建自己的 ane 文件:
http://help.adobe.com/en_US/air/extensions/index.html
你也可以直接使用第三方提供的 ane (包括 Adobe 官方的)

http://www.adobe.com/devnet/air/native-extensions-for-air.html

有了 ane 文件就可以在移动项目中应用一些 Air 原生不支持的功能了,下面是一些注意事项(例子中用到了上面地址中的?Notification 和?Vibration 两个 ane):

• 引入 ane:
  将 ane 文件拷贝到项目目录(一般是 lib 或 ane 文件夹中),右键->Add To Library
• 修改 ane 引入方式:
  ane 文件上右键->Options...,修改为 External library(not included);
• 修改 application.xml 描述文件,引入 ane 支持:
  本例中引入了两个 ane 文件,因此需要增加如下代码:
  

   <extensions>
      <!-- Vibration ane 的 extension id -->
      <extensionID>com.adobe.Vibration</extensionID> 
      <!-- notification ane 的 extension id -->
      <extensionID>com.adobe.mobile</extensionID>
   </extensions>

  当然 FD 4 为此也提供了 UI 支持,单击图一中所示按钮,进入 Extensions 选项卡(图二)进行编辑.
  

  

  
  (图一)
  

  

  
  (图二)
• 增加一些额外支持描述:
  本例中?Vibration 需要增加权限描述,Notification 要增加服务描述(相应的 ane 下载页面中有相关说明),你可以直接修改 application.xml 或者在上面提到的界面中设置(图三)
  

  

  
  (图三)
  
• 修改打包批处理命令:
  由于 FD 的编译打包过程都是通过批处理来实现的,要增加 ane 支持,需要对 Packager.bat 文件稍作修改,
  在 %FILE_OR_DIR% 后面增加?-extdir lib/ 一段(不换行),?lib 为 ane 所在目录相对路径.

提供本例测试 ane 部分代码(直接放在文档类构造函数里就行):

// 震动实现
if (Vibration.isSupported)
{
    var v:Vibration = new Vibration();
    v.vibrate(2000);
}

// 系统提醒
try
{
    var nom:NotificationManager = new NotificationManager();
}
catch (err:Error)
{
    return;
}

var n:Notification = new Notification();

n.tickerText = '提醒时状态栏中显示的文字';
n.title = '提醒的标题';
n.body = '和内容';
// 提醒图标类型
n.iconType = NotificationIconType.INFO;

nom.notifyUser('MY_NOTIFY_TYPE',n);

基本上需要注意的就这么多,现在可以在设备上测试一下了,可能会发生的状况是: 运行程序后,手机震动的同时在状态栏出现一条提示,打开状态栏看到带有 info 图标以及标题和内容的一条提醒.

-EOF-