注:這是一篇由 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*協議發佈。