注:这是一篇由 Andrew Shorten原创文章的更新和扩展版本。
\Flash Builder 4.5 包含对Google Android、Apple iOS和 BlackBerry Tablet OS设备的Flex和ActionScript 应用程序进行打包的支持功能。 为各种平台获取签字证书和配置应用程序包的过程是完全不同的。
\本文和视频旨在帮助 ActionScript和 Flex 开发人员完成必要的步骤,以便在项目的开发、测试和部署阶段,利用 Flash Builder创建的应用程序能够安装到BlackBerry Tablet OS设备上。
\关于对其它平台的应用程序进行打包的更多信息,请查阅下列文章:
\为了在开发期间测试你的应用程序,你可以在一个连接的设备上或在一个仿真器中运行和调试它。 仿真器能够在无需执行签名/配置(signing/provisioning)的情形下,可以提供运行应用程序的快速和简便方法,当然,它也有其局限性,即它不能够完全复制一个实际设备的性能。 你可以使用Flash Builder 设备仿真器或更为复杂的 BlackBerry PlayBook仿真器来仿真应用程序。
\Flash Builder设备仿真器是一种能够以最快的方式看到你的应用程序在 BlackBerry Tablet OS 设备上表现的解决方案。 它能够以正确的尺寸和分辨率在一个窗口中显示应用程序。 它还具有一个设备菜单以便仿真设备的旋转操作和若干设备按钮。
\图 1. 使用设备仿真器为 BlackBerry PlayBook创建一个运行配置(run configuration) 。
\注:如果你没有Blackberry Tablet OS target platform选项,则转到Project \u0026gt; Properties \u0026gt; Flex或 ActionScript Build Packaging \u0026gt; BlackBerry Tablet OS,然后选中 Enable this target platform。
\图 2. 利用Flash Builder 设备仿真器运行应用程序 。
\为了在能够更加真实地模仿 BlackBerry Playbook体验的仿真器中运行应用程序,你需要下载、安装和设置 相应的BlackBerry PlayBook 仿真器。
\你需要做的第一项操作是下载和安装 BlackBerry Tablet OS SDK。 它包含与Flash Builder集成以便在 BlackBerry Tablet仿真器中运行和调试的代码,以及在实际设备上运行和调试的代码,以便为BlackBerry App World 商店创建应用程序的发布版本。
\图 3. 下载SDK
\ 如果你是一个注册的BlackBerry Developer Zone Member,请登录;否则,点击Not a BlackBerry Developer Zone Member旁边的加号,输入你的个人信息,然后点击 next。 在后一种情形下,系统提供一个可选的复选框以便你使用这一信息使自己变成为一个Blackberry Developer Zone Member。\ 下载 SDK。\ 如果Flash Builder处于打开状态,请关闭它。\ 运行相应的安装程序以便安装 SDK。 注意你安装SDK的位置;你可能希望将它安装于 Flash Builder的sdks 文件夹中,尽管这不是默认的位置。 BlackBerry PlayBook仿真器是与BlackBerry Tablet OS SDK一起安装的(参见图4)。\ \图 4. 下载和安装BlackBerry Tablet OS SDK
\为了能够在BlackBerry PlayBook 仿真器或设备中运行应用程序,你需要在Flash Builder中注册相应的 SDK路径。
\图 5. 在 Flash Builder中注册SDK
\BlackBerry Playbook仿真器需要VMWare。 如果在实际设备上进行测试之前你希望利用仿真器对你的应用程序进行调试,你需要下载和安装VMWare(如果你没有安装VMWare的话)。 在你购买VMWare之前,你可以全功能免费试用该软件30天。
\图 6. 下载VMWare.
\ 下载并且安装 VMWare。\ 打开VMWare 并且点击Get Serial Number按钮,然后输入你的***或按照相应链接和步骤获取一个试用30天的***。\下面安装和启动BlackBerry PlayBook 仿真器。
\图 7. 启动 BlackBerry PlayBook仿真器
\为了能够在仿真器中运行你的应用程序,你需要为Flash Builder提供仿真器的 IP地址。 每次当BlackBerry PlayBook 仿真器启动时,VMware Fusion 均为其分配一个IP地址。 为了显示IP地址,仿真器必须处于开发模式(development mode),仿真器的默认模式就是开发模式。
\在 BlackBerry PlayBook 仿真器中,点击状态栏中的时钟右侧的图标(参见图8),然后获取其IP地址。
\ \图 8. 获取BlackBerry PlayBook 仿真器的IP地址
\在你获取仿真器的IP地址之后,你可以在Flash Builder中将其注册为测试设备。
\图 9. 将 BlackBerry Playbook 仿真器添加为测试设备
\ 点击OK。 现在PlayBook Simulator 将被显示为测试设备(参见图10)。\ 点击OK 以便关闭Preferences对话框。\ \图 10.将 BlackBerry Playbook 仿真器注册为测试设备
\现在,你可以在仿真器中运行应用程序。
\图 11.将 BlackBerry Playbook 仿真器注册为测试设备
\ 点击Run按钮。 Flash Builder 将创建一个应用程序包,将其连接至仿真器,然后部署应用程序(参见图12)。\ \图 12.在 BlackBerry PlayBook 仿真器中运行应用程序
\ 从仿真器窗口的底部进行划屏操作(就像你在实际的PlayBook中动作一样)以便返回到主视图。 你将看到你的应用程序的图标(参见图13)。 你将在后面的章节学习如何定制应用程序的名称和图标。\ \图 13.寻找安装于仿真的PlayBook中的应用程序的调试版本
\ 返回到Flash Builder中,然后在你项目的bin-debug文件夹中找到相应的BAR 应用程序包文件(参见图14)。 这是开发的应用程序的一个调试版本。 在后面的章节中,你将学习如何创建用于发行的BAR的发布版本。\ \图 14.寻找已创建的 BlackBerry Tablet OS 调试包
\在你在设备上运行和调试应用程序之前,你必须使用Flash Builder创建一个开发人员证书,然后创建和上载一个调试令牌到该设备上。 为了通过使用Flash Builder创建证书,你首先需要从RIM获得代码签名**。 这一过程是免费的,但需要花费长达48小时才能完成。
\浏览到 BlackBerry Code Signing Keys Order Form*,然后填写并且提交该表格(参见图15)。 确保将key字段设置为BlackBerry Tablet OS Code Signing Key。 在你提交表格之后,你将从RIM收到一份订单确认电子邮件。
\你必须记住你在这里指定的公司名称和你设置的PIN。 因为你稍后需要这两个值。
\ \图 15.注册代码签名**
\在48小时之内,你应该从RIM收到两封电子邮件,每封带有一个CSJ注册文件附件(参见图16)。 将client-RDK.csj和client-PBTD.csj文件保存到你的计算机中。
\ \图 16.获取和保存CSJ文件
\一旦你收到CSJ文件,你可以在Flash Builder中利用RIM Signing Authority进行注册。
\在Flash Builder中,转到 Flash Builder \u0026gt; Preferences \u0026gt; Flash Builder \u0026gt; Target Platforms \u0026gt; BlackBerry Tablet OS \u0026gt; Signing。
\注:你在进行这些注册时必须处于在线状态,因为 Flash Builder必须与RIM进行通信以便完成这些注册过程。 如果你需要配置 Flash Builder以便通过一个代理服务器进行通信,请查阅RIM网站的相应文档*。
\ \图 17.利用 RIM Signing Authority进行注册
\ 点击OK。 在 Signing页面中,你应该看到你已经处于注册状态(参见图18)。 你只能利用RIM Signing Authority 为一组CSJ文件注册一次。\ \图 18.利用 RIM Signing Authority成功进行注册
\下面,你将使用Flash Builder创建一个开发人员证书。 你需要使用该证书创建一个调试令牌以及为应用程序的打包进行签名。
\图 19.在 Flash Builder中创建一个开发人员证书
\ 设置和确认一个密码,然后点击OK。 你应该在 Signing页面的上部看到列出的证书(参见图20)。\ \图 20.设置开发人员证书
\为了能够在 BlackBerry Tablet OS 设备上运行和调试应用程序,你需要在设备上创建和安装一个调试令牌。 你可以使用Flash Builder 创建一个调试令牌,然后利用在该调试令牌中指定的author和author ID 配置你的应用程序,这样你的应用程序能够在无需签名的情形下运行。
\利用 Flex 4.5.1 SDK创建的应用程序需要Adobe AIR 2.6 或更高版本支持才能运行。
\图 21.核查应用程序要求的 AIR 运行时版本号
\ 在设备上,转向Settings \u0026gt; About,从下拉菜单中选中OS,然后找到安装于设备上的AIR 版本号(参见图22)。\ \图 22.找到设备上的 AIR 版本号
\ 如果设备中没有要求的AIR 版本,转到Settings \u0026gt; Software Updates,然后点击Check for Updates;如果存在可用的较新软件版本号,则安装该版本。\为了能够在设备上运行应用程序,该设备必须处于开发模式并且你需要其开发密码。
\图 23.在设备上启用开发模式(development mode)
\为了能够使用 Flash Builder注册设备以及为其创建一个调试令牌,你需要其IP地址。
\在设备上,点击状态栏中的时钟右侧的Development图标(参见图24),然后获取其IP地址。
\ \图 24.获取设备的IP地址
\现在你可以在Flash Builder注册设备。
\图 25.在 Flash Builder中注册设备
\注:在该对话框中有一个用于创建调试令牌的复选框,但我在试图利用这一方法创建令牌时总是出错;因此下一步我将使用一个不同的过程。
\ 点击OK 以便关闭Preferences对话框。\通过一个USB电缆将该设备与计算机相连。
\在Flash Builder在开发阶段在设备上安装应用程序的调试版本之前,该设备必须安装一个调试令牌。
\图 26.自动寻找设备的PIN码
\ 在 Auto Discover 对话框中,点击OK。 你将获得一个 Upload Debug Token 对话框。 与该对话框中给出的内容相反,你不需要将设备设置为调试令牌上载模式(debug token upload mode)来获得其PIN码。\ 在 Auto Discover 对话框中,点击OK。 你将获得一个 Upload Debug Token 对话框。 与该对话框中给出的内容相反,你不需要将设备设置为调试令牌上载模式(debug token upload mode)来获得其PIN码。\ 在 Add Devices对话框中,点击OK。\ 在 Create Debug Token 对话框中,设置相应的名称和保存令牌的位置,然后点击OK(参见图27)。 你将获得一个Password对话框。\ \图 27.在你的计算机中保存调试令牌文件
\ 在 Password 对话框中,输入你在利用RIM Signing Authority在 Flash Builder中进行注册时设置的 CSK 密码。\ 在 Password对话框中,点击OK。 已经创建和保存调试令牌文件(参见图28)。\ \图 28.在Flash Builder看到的调试令牌
\在调试令牌创建之后,你需要将其安装到你的 BlackBerry Tablet OS 设备上。
\图 29.将设备设置为debug token upload mode
\ 在Flash Builder中,转到 Flash Builder \u0026gt; Preferences \u0026gt; Flash Builder \u0026gt; Target Platforms \u0026gt; BlackBerry Tablet OS \u0026gt; Signing。\ 选中相应的调试令牌,然后点击 Upload(参见图28)。\ 在 Upload Debug Token to Devices对话框中,选中相应的设备(参见图30)。\ \图 30.选中需要上载调试令牌的设备
\ 点击OK。 你将获得一个 Upload Debug Token 对话框(参见图31)。\ \图 31.确认你的选择
\ 你已经将设备设置为debug token upload mode,因此点击OK。 调试令牌将被上载到该设备。 在上载完毕之后,你将在设备上看到其信息(参见图32)。\ \图 32.在设备上寻找调试令牌信息
\在你利用安装的调试令牌在设备上运行或调试应用程序时,你必须确保应用程序的blackberry-tablet.xml文件是利用正确的 author和 author ID值配置的。
\图 33.在Flash Builder获取调试令牌细节详细信息(debug token details)
\现在你需要将应用程序的author和author id值设置为在调试令牌中设置的相应值。
\\\u0026lt;qnx\u0026gt;\ \u0026lt;author\u0026gt;MyCompany\u0026lt;/author\u0026gt;\ \u0026lt;authorId\u0026gt;gYAAgIqK0RLL5u4I9NanyxBUuCI\u0026lt;/authorId\u0026gt;\\u0026lt;/qnx\u0026gt;\\
你也可以在blackberry-tablet.xml文件中将应用程序图标设置为能够在设备上使用的图标。 图标应该是86x86 像素(或更小)的 PNG或 JPG。 大于86x86 像素的图标将不能在设备屏幕上显示。
\\\u0026lt;qnx\u0026gt;\ \u0026lt;author\u0026gt;MyCompany\u0026lt;/author\u0026gt;\ \u0026lt;authorId\u0026gt;gYAAgIqK0RLL5u4I9NanyxBUuCI\u0026lt;/authorId\u0026gt;\\ \u0026lt;icon\u0026gt;\ \u0026lt;image\u0026gt;assets/appicon86x86.png\u0026lt;/image\u0026gt;\ \u0026lt;/icon\u0026gt;\\u0026lt;/qnx\u0026gt;\\
你也可以在 blackberry-tablet.xml文件中设置应用程序许可。你可以寻找可能的值然后直接输入它们或在 Flash Builder对话框中选中它们。
\图 34.设置应用程序许可
\ 点击OK。 如果你选中任一许可,则新的permission元素将被添加到你的blackberry-tablet.xml文件中(参见图35)。\ \图 35.寻找添加的许可
\最后,设置在设备上显示的应用程序名称。
\图 36.设置应用程序的名称和id
\最后,你将能够在设备上运行应用程序。
\图 37.创建一个用于在 Blackberry Tablet OS 设备上运行应用程序的run configuration
\ 点击Run按钮。 Flash Builder将创建相应的应用程序包,然后在设备上安装并且启动该应用程序(参见图38)。\ \图 38.在 BlackBerry Tablet OS 设备上运行应用程序
\ 从设备屏幕的底部进行划屏操作以便返回到主视图,然后寻找你的应用程序的图标(参见图39)。\ \图 39.在设备上寻找应用程序的调试版本的图标
\ 返回到Flash Builder中,然后在你项目的bin-debug文件夹中找到相应的BAR 应用程序包文件(参见上面的图14)。 这是安装于设备的应用程序的调试版本。 在下面的章节中,你将学习如何创建用于发行的BAR的发布版本。\为了在设备上调试应用程序,你可以使用 Flash Builder在设备上创建、安装和启动一个调试BAR包,就像你在设备上运行应用程序一样。 不过,对于调试来说,你的计算机和设备必须位于相同的Wi-Fi 网络。 可以使用USB 电缆在设备上安装应用程序;当对应用程序进行运行和调试时,可以使用 Wi-Fi 网络实现设备和Flash Builder之间所有通信任务。
\在Flash Builder中,从Debug按钮的下拉菜单中选中Blackberry Tablet OS 设备配置文件。 在BAR 包创建之后,它将在设备上安装并且启动,然后 Flash Builder 调试器将连接到在设备上运行的应用程序。 当代码运行到一个断点时, 应用程序将暂停,然后你可以使用 Flash Builder对代码进行单步调试,就像你使用 Flash Builder 设备仿真器或 BlackBerry Playbook 仿真器进行调试一样。
\如果你在设备调试过程中遇到问题,请检查是否你的计算机处于一个v*n网络之中或使用防火墙软件。 如果计算机处于一个v*n网络之中但设备没有,则你需要将计算机脱离该v*n网络以便调试操作能够正常进行。 如果你的防火墙已经打开,则设法关闭它。 如果你不能够或不希望关闭防火墙,则设法打开端口7935,Flash Builder 调试器将使用该端口与设备进行通信。
\当你完成你的测试并且准备好为在BlackBerry App World中推出应用程序的发布版本进行打包时,你需要使用Flash Builder的Export Release Build向导。
\在打包之前,你需要设置应用程序的版本号。 BlackBerry Tablet OS 应用程序的版本号由一串4个采用句号分隔的号码构成: (Major).(Minor).(Revision).(Build),例如,1.0.5.357。 每次当你对应用程序进行签名和打包时,你必须至少改变版本号的一个号码。 你可以通过更新application-descriptor文件的versionNumber元素来改变major、minor和revision号码。 同样,你可以通过更新blackberry-tablet.xml文件的buildId元素来改变build号码。 它可以是0至65535之间的任一数字。
\图 40.改变应用程序的版本号
\如果你没有进行下面设置操作,请设置应用程序的 id、名称、应用程序图标和许可。 关于相关的详细信息,请参阅在前面章节中给出的步骤9–12。
\最后,生成一个用于发行的已经签名的 BAR 文件。
\图 41.创建一个发布版本
\ 在 Packaging Settings页面中,选中Enable digital signing(参见图42)。\ \图 42.为发布版本启用数字签名
\ 点击Finish按钮。 Flash Builder 将为你的应用程序创建一个BAR 文件。\ 寻找发布的应用程序包(参见图43)。\ \图 43.寻找应用程序的发布版本
\ 现在你可以将该文件提交到 BlackBerry App World的厂商门户(Vendor Portal for BlackBerry App World)*,以便RIM进行审阅。 你可以通过按照 本文档*给出的相应步骤来验证一个BAR文件的签名是否合理。\在本文中,你已经学习了如何使用Flash Builder 和BlackBerry Tablet OS SDK在BlackBerry Tablet OS 设备上运行和调试 Flex和ActionScript应用程序。 此外,你还学习了如何为你的发行应用程序创建发布版本。 如需获得更多信息,请参阅下列资源:
\Adobe 网站:
\RIM 网站:
\
\本文基于Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License*协议发布。