AIR应用开发中文指南

AIR应用开发中文指南(BETA2)如转载，请注明：译者：常青博客：整理：飞鸟博客：第一章.开始AdobeAIR之旅1.1什么是AdobeAIR1.2安装AIR运行时及例程1.3设置开发环境1.4分发，安装和运行AIR应用程序1.5关于AIR的安全性1.6AIR文件结构第二章.设置FlexBuilder2.1关于FlexBuilder对于AIR的支持情况2.2从FlexBuilder2.0.1迁移到FlexBuilder3第三章.设置FlexSDK3.1在Windows下安装和配置Flex3SDK3.2删除mms.cfg设置第四章.用FlexBuilder创建第一个FlexAIR程序4.1新建一个AIR工程4.2编写代码4.3测试写好的程序4.4打包并运行程序第五章.用FlexSDK创建第一个FlexAIR程序5.1创建应用程序描述文件5.2编写程序代码5.3编译程序代码5.4测试程序5.5打包程序第六章.用FlexBilder开发AIR程序6.1创建AIR工程6.2调试AIR程序6.3打包程序6.4创建AIR库工程第七章.使用FlexAIR组件7.1关于FlexAIR组件7.2使用WindowedApplication组件7.3关于HTML组件7.4Window容器第八章.使用命令行工具创建AIR应用程序8.1使用amxmlc编译器编译程序代码8.2使用acompc编译器编译AIR组件和库8.3使用AIR调试器(ADL)调试程序8.4使用AIR开发工具(ADT)打包程序8.5在简单的工程项目中使用Ant8.6在复杂的工程项目中使用Ant第九章.设置应用程序属性9.1应用程序描述文件的结构9.2定义应用程序描述文件中的属性9.3AdobeAIR新增功能第十章.窗体（Windows）和菜单10.1AIR窗体基础10.2创建窗体10.3控制窗体10.4监听窗体事件10.5使用全屏窗体模式10.6屏幕10.7AIR菜单简介10.8创建本地菜单第十一章.文件与数据11.1AIR文件系统概要11.2使用File对象11.3获取文件系统信息11.4目录11.5文件11.6加密的本地存储11.7拖拽(DragAndDrop)11.8复制与粘贴11.9本地SQL数据库第一章.开始AdobeAIR之旅什么是AdobeAIRAdobeIntegratedRuntime(AIR)是一个跨操作系统的运行时，利用现有的Web开发技术（Flash，Flex，HTML，JavaScript，Ajax）来构建富Internet应用程序并部署为桌面应用程序。AIR支持现有的Web技术如Flash，Flex，HTML，JavaScript和AJAX，可以用你昀熟练的技术来开发您所见过的昀具用户体验的RIA程序，例如，一个AIR程序可以使用如下一种或多种组合技术构建：•‚Flash/Flex/ActionScript•‚HTML/JavaScript/CSS/Ajax•‚PDF可嵌入任何应用程序中作为结果，AIR应用程序可以是：•‚基于Flash或Flex：应用程序根内容（理解为容器）为Flash/Flex(SWF)•‚基于Flash或Flex的HTML或PDF。应用程序的根内容为基于Flash/Flex(SWF)的HTML(HTML,JS,CSS)或PDF•‚基于HTML，应用程序根内容为HTML,JS,CSS•‚基于HTML的Flash/Flex或PDF，应用程序根内容为基于HTML的Flash/Flex(SWF)或PDF用户使用AIR应用程序的方式和传统桌面程序是一样的，当运行时环境安装好后，AIR程序就可以其他桌面程序一样运行了。因为AIR是应用程序运行时环境，因此她很小且对用户来说不可见。运行时环境提供了一套一致的跨操作系统平台和框架来开发和部署应用程序，因此你的程序不必到每个平台上进行测试，在一个平台上开发好就可以在其他平台上运行了，这有很多好处：•„‚开发AIR应用程序不必做额外的跨平台工作，节省了时间，因为跨平台的工作AIR都帮我们做好了（只要其他平台能支持AIR）。•„‚比起Web技术及其设计模式，AIR应用程序开发迅速，她允许将Web开发技术搬到桌面上来而不用另外去学习桌面程序开发技术或复杂的底层代码，这比起低级语言如C和C++更容易学习，且不用去处理每个操作系统复杂的底层APIs。安装运行时及例程AIR允许在桌面上运行富Internet应用程序（富客户端）。首先，你需要在计算机上安装一个运行时环境，装好后，下载示例程序，试着运行下，看看在桌面上跑的AIR程序会是什么样子。安装运行时环境按照下面的说明下载和安装Windows或MacOSX版本的AIR,只需要装一次，您就可以在任何时候运行AIR程序了。安装Windows版本1.从AdobeLabs站点下载安装文件(AIR1_win_beta1.exe)。2.双击安装文件AIR1_win_beta1.exe。3.根据提示完成安装。4.如果你修改了mms.cfg文件，则在运行AIR程序之前删除它，在Windows操作系统中该文件放置在C:\winnt\system32\macromed\flash\mms.cfg。安装MacOS版本1.从AdobeLabs站点下载安装文件(AIR1_mac_beta1.dmg)。2.双击安装文件AIR1_mac_beta1.dmg。3.根据提示完成安装。4.如果安装时出现认证窗口，输入MacOS用户名和密码。5.如果你修改了mms.cfg文件，则在运行AIR程序之前删除它，在MacOS操作系统中该文件放置在/Library/ApplicationSupport/Macromedia/mms.cfg。安装和运行AIR示例程序AIRbeta1包含了一些示例程序。1.从AdobeLabs站点下载AIR示例程序。2.双击AIR文件。3.在安装窗口中选择installation选项，点Continue。4.安装完成后，打开程序。5.在Windows系统中，双击桌面上的程序图标。6.在MacOS系统中，双击程序图标，它安装在用户目录的Applications子目录中(例如,MacintoshHD/Users/JoeUser/Applications/)。运行AIR应用程序一旦安装好了运行时环境和AIR程序，那运行AIR程序和一般的桌面程序就差不多了：设置开发环境在编写AIR程序之前，你还需要设置开发环境。在FlexBuilder3中可开发基于Flex和基于ActionScript的AIR程序，或者使用Flex和AIRSDKs的命令行工具，如果开发基于HTML的AIR程序，必须要AIRSDK，它包含了打包程序所需要的工具。分发，安装和运行AIR应用程序AIR程序是非常易于安装的，无缝安装特性让用户安装昀新的AIR运行时，安装AIR程序，装好后，就可以和普通桌面程序一样运行了。一旦打包好了AIR程序，有几种途径进行分发：1.你可以直接通过电子邮件或Web页面来发送AIR安装包给终端用户。2.也可以在Web页面上加入一个无缝安装链接，无缝安装特性可在Web页面上提供一个链接让用户通过点击改链接来安装AIR程序。如果用户没有安装AIR运行时，则会提示用户安装运行时，无缝安装技术也可让用户不必下载AIR文件就可以安装AIR程序。如果用户下载了AIR文件，只要双击文件即可启动AIR安装向导，如果用户点击了Web页面的无缝安装链接，则会弹出对话框提示用户是否立即安装AIR程序。Windows系统中在默认设置下，安装AIR程序会：1.安装在ProgramFiles目录2.创建桌面快捷键3.创建开始菜单快捷键4.在添加/删除控制面板中添加程序操作项目在MacOS中，默认下AIR程序安装在用户目录中的Applications子目录下。如果程序已经安装，则安装向导会提示用户是否打开程序或者更新程序，安装器是根据应用程序的ID（appID）来确定的。关于AIR安全性AIR环境提供和一般桌面程序类似的，能够访问操作系统资源的能力，AIR程序比起SWF或浏览器中HTML文件来约束更小些，因此可能会出现安全问题，所以正确理解AIR程序的安全模型非常重要。安装向导安全警告在AIR程序安装过程中，用户会看到一个安全提示，这是AIR程序开发者给出的提示信息以及允许程序访问的操作系统类型，这些信息让用户在安装程序时有个大致了解。安全沙漏在AIRbeta版本中，在特定的安全沙漏中AIR程序可访问本地文件系统，在将来的AIR版本中，应用程序资源将有着不同的安全沙漏，这取决与AIR程序是如何被安装的。对于SWF你可以设置安全沙漏类型属性（sandboxType属性）为只读，因为SWF可以包含在AIR程序里，该属性是Security.APPLICATION的一个常量。所有未和AIR程序一起安装的其他资源都被放入同一个安全沙漏中，远程资源根据源域放入沙漏中，本地资源被放入local-with-networking，local-with-filesystem，或local-trusted。AIR程序安全沙漏中的资源访问特权AIR应用程序安全沙漏中的SWF可以通过脚本访问来自其他域中的SWF文件，但是默认下，外部的SWF要想访问AIR应用程序安全沙漏内的SWF则会受到约束。AIR程序沙漏中的SWF文件和HTML内容可读取任何域中的内容及其数据。随AIR程序安装的SWF文件不必寻找cross-domain策略文件，要提升权限可调用Security.allowDomain()方法。AIR为AIR程序安全沙漏中的SWF文件和HTML内容提供了增强型的特权，其中包括读取和写入本地资源和文件。健壮的应用程序开发昀佳实践当编写AIR程序时，你要知道虽然你使用了Web技术，但是却不受浏览器安全沙漏限制，也就是说AIR程序可能有意或无意中破坏本地系统，AIR真试图把这种风险降低到昀小，但是类似此方面的漏洞仍然可能出现。产生风险的昀大可能就是在读取外部数据或内容时，因此你必须时刻注意使用中的数据是否来自于网络还是本地系统，下面的这些例子都有可能存在潜在的风险：引入外部内容时这将导致脚本注入风险：1.如果一个TextField对象读取的内容中包含链接，则该链接可能会执行不可预料的结果。2.如果程序读取一个非信任的SWF，则该SWF可能会以非法特权执行。3.如果程序从外部程序中读取JSON内容，则该内容可能会访问运行时特权。影响程序行为的数据这将会导致弱安全性。比如，如果一个程序使用来自网络上的数据去检测一个文件名或写入一个配置文件，因此需要检测这些数据是否安全以及是否来自信任的数据源。现在的AIR还是beta版，如果你遇到了诸如配置和选项的弱安全问题，请告诉Adobe，目前Adobe现在处理这些安全问题，到时他们将会优先给你一份AIR1.0的正式版本。对于HTML内容的安全约束HTML内容和其他AIR内容一样都放在同一个安全沙漏模型中操作，但是这里有些特殊的情况。如果内容都在程序安全沙漏内，则HTML控制对象中的HTML内容只能访问安全约束的runtime类（如JavaScript对象window.runtime）。对于基于HTML的程序来说，从应用程序资源目录中载入的数据（顶层Frame）总是可以访问runtime类，而从应用程序资源外部载入的数据无论是子框架还是(IFRAME)，还是通过页面定位读取的数据，其权限与原来的域保持一致，不能访问受AIR安全约束的runtime类，默认下非程序内容是不能访问跨脚本内容，如JavaScriptwindow属性，nativeWindow和htmlControl不能在程序沙漏外工作。要想安全访问脚本，可以使用theflash.system.DoorAPI创建严密的通信网关在程序内容和非程序内容之间提供一个有限的接口。AIR文件结构除了所有文件及图片等资源文件之外，下面两个文件是