将您的AIR程序加上自动更新功能
15 二 2009
AIR 1.5 加入了自动升级的类air.update.ApplicationUpdater，为基于AIR的应用程序能通过网络更新到最新版本有了保障。如果发布自己的AIR程序建议加上自动升级功能，好处当然不用多说。
其原理也很简单，ApplicationUpdater 会去读取网络上的一个版本描述文件，描述文件事是一个特定的XML文档，其中包含了版本号和对应的安装文件路径以及更新描述信息。然后和当前运行的AIR程序版本进行比较，来决定是否下载和安装。
整理了一下代码，在以后的AIR程序中只要简单的引入这个类文件即可实现检查新版本和安装新版本的AIR程序。
这里来测试，注意标题栏的版本号，升级成功后为2.0
[airbadge]AutoUpdate Tester,http://cbmland.com/air/AutoUpdate/AutoUpdate.1.0.air,1.0,http://cbmland.com/uploads/2009/02/2009-02-15_202552.png[/airbadge]
版本描述文件
|
1 2 3 4 5 6 7 8 9 10 |
<?xml version="1.0" encoding="utf-8"?> <!-- update.xml --> <update xmlns="http://ns.adobe.com/air/framework/update/description/1.0"> <version>2.0</version> <url>http://cbmland.com/air/AutoUpdate/AutoUpdate.air</url> <description> <text xml:lang="en_US">AIR AutoUpdate</text> <text xml:lang="zh_CN">AIR 自动更新</text> </description> </update> |
UpdateUtil.as
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 |
package com.cbmland.utils { import air.update.ApplicationUpdater; import air.update.events.DownloadErrorEvent; import air.update.events.StatusUpdateEvent; import air.update.events.UpdateEvent; import flash.events.ErrorEvent; import flash.events.Event; public class UpdateUtil { private var au:ApplicationUpdater; /** * * @param updateURL 版本描述文件URL * @param eventHandle 事件挂钩 * */ public function UpdateUtil(updateURL:String,eventHandle:Function = null){ au = new ApplicationUpdater(); //设置版本描述文件URL this.au.updateURL = updateURL; //如果有事件挂钩便进行事件监听 if(eventHandle){ this.au.addEventListener(ErrorEvent.ERROR,eventHandle) this.au.addEventListener(UpdateEvent.CHECK_FOR_UPDATE,eventHandle) this.au.addEventListener(UpdateEvent.INITIALIZED,eventHandle) this.au.addEventListener(UpdateEvent.DOWNLOAD_START,eventHandle) this.au.addEventListener(UpdateEvent.DOWNLOAD_COMPLETE,eventHandle) this.au.addEventListener(UpdateEvent.BEFORE_INSTALL,eventHandle) this.au.addEventListener(StatusUpdateEvent.UPDATE_STATUS,eventHandle) this.au.addEventListener(DownloadErrorEvent.DOWNLOAD_ERROR,eventHandle) } //初始化 this.au.initialize() //开始检查 this.au.checkNow() } } } |
AutoUpdate.as
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 |
package { import com.cbmland.utils.UpdateUtil; import flash.display.Sprite; import flash.events.Event; import flash.events.StatusEvent; import flash.text.TextField; public class AutoUpdate extends Sprite{ private var console:TextField; public function AutoUpdate() { initConsole() new UpdateUtil('http://cbmland.com/air/AutoUpdate/update.xml',eventHandle) } private function initConsole(){ console = new TextField() console.width = this.stage.stageWidth; console.height = this.stage.stageHeight; console.border = false; console.multiline = true; console.wordWrap = true; this.addChild(console) } private function eventHandle(event:Event){ console.appendText(event+'\n'); if(event is StatusEvent){ doUpdate(event) } } private function doUpdate(event:Event):void{ if(event.available==true){ event.preventDefault() au.downloadUpdate() } } } } |
源码下载
AutoUpdate.zip (9.0 KiB, 1,233 hits)
AIR 程序自动更新测试
有几个需要注意的不得不提醒一下。
需要Flex SDK 3.2才支持AIR 1.5
XML中的版本号和指定的AIR程序的版本号一定要保证匹配，比如1.0千万不要写成了1.00了。
如果在ADL中看到报错[ErrorEvent type="error" bubbles=false cancelable=false eventPhase=2 text="Cannot update (from remote)" errorID=16828]
请使用发行版本来测试，调试版本不支持升级安装。
- 21 Comments , 21,109 Hits
- Filed under: 代码人生, 分享我自己
-
Tags: Action Script, AIR
21 Responses for "将您的AIR程序加上自动更新功能"
-
博主您好，申请贵站的友情连接，贵站连接已经做好
希望能通过！
我的博客是www.ds313.cn/博客名称是 vancl-
已加.
楼主，现在引用这个例子，出现个错误：[DownloadErrorEvent (type=downloadError text=Different applicationID id=16824 subErrorID=16825)]，恳求解答！
-
applicationID 不同，应该是改动了app.xml的属性。
博主，请解答一下“请使用发行版本来测试，调试版本不支持升级安装。”你的这句话好吗？你指的是发行版的AIR还是什么？
-
调试版本就是ADL.exe，用户环境的是可以的。
-
博主能详细的解说一下出现[ErrorEvent type="error" bubbles=false cancelable=false eventPhase=2 text="Cannot update (from remote)" errorID=16828]
这个错误的解决方案吗？谢谢！-
文章最下一句不说说明了吗？开发版本不支持。
请用用户版本运行测试。-
博主，我也遇到了同样的问题，能麻烦发下”用户版本”的连接吗？开发版本和用户版本都实在搞不太清楚，跪谢博主!
-
是需要购买正版Flex Builder才支持在线安装吗？
-
去官方网站下载安装即可。关于图表方面的组件是需要许可的。其他的基本没问题。应为sdk是免费的。
-
博主，刚才安装你给的那个版本，还是报errorID=16828的错误，我SDK是3.2的，博主觉得还是别的问题会引发这个错误吗？看网上说Air不能是Debug Launcher版本的，那要哪种版本才能支持呢？
AutoUpdate.as
这个类当中的方法
private function doUpdate(event:Event):void
event没有available这个属性。。。
还有这个au哪里来的？？？-
请用3.2以上的SDK编译。
为什么你这个例子里面的东西不能升级安装到2.0啊！是不是有错啊
还有你的这个例子怎么不能下载啊 AutoUpdate.zip ！能不能把你那运行的给我法一份啊！我邮箱[email protected] QQ：634955250 谢谢！
Flex There was an error downloading the update. Error# 16820 这个是什么错误啊！还有更新的程序路径，这个更新的程序应该怎么写！
这个例子怎么不能下载啊 AutoUpdate.zip ！能不能把你那运行的给我法一份啊！我邮箱[email protected]谢谢
请问楼主为什么会出现error1009的问题呢？
请问博主：#error 16831是怎么回事
Leave a Reply
-
-
-
-
-
2009-02-20 15:02