顯示具有 AIR 標籤的文章。 顯示所有文章
顯示具有 AIR 標籤的文章。 顯示所有文章

2010年12月24日 星期五

網頁與AIR程式互動

如果需要在Browser上可以與AIR應用程式做互動,如安裝AIR App,或由網頁上的Click觸發啟動AIR App,以下是相關執行程序

一.準備工作
1.AIR程式端設定AIR程式允許透過Browser觸發
設定AIR發布用的application.xml的
 <application xmlns="http://ns.adobe.com/air/application/2.0">  
建議設定發布為AIR 1.53以上版本,因為如果AIR為1.53之前的版本,Browser要呼叫AIR,一定要知道AIR的PID值(在AIR內可以用NativeApplication.nativeApplication.publisherID取得)。若AIR為1.53後的版本,若Browser不知道AIR的PID,可以用""代即可。

加入
 <allowBrowserInvocation>true</allowBrowserInvocation>  
讓AIR允許被Browser啟動

2.Browser端Flash取得AIR Browser API
Browser端Flash要操作AIR所要用的API都放在http://airdownload.adobe.com/air/browserapi/air.swf內
透過loader載入這個檔案即可使用相關功能

public var airSWF:Object;
public var airSWFLoader:Loader = new Loader();
public var loaderContext:LoaderContext = new LoaderContext();
loaderContext.applicationDomain = ApplicationDomain.currentDomain; 
airSWFLoader.contentLoaderInfo.addEventListener(Event.INIT, onInit); 
airSWFLoader.load(new URLRequest(" http://airdownload.adobe.com/air/browserapi/air.swf"), loaderContext);
private function onInit(e:Event):void { 
    airSWF = e.target.content;
    airSWF.getApplicationVersion(appID, pubID, versionDetectCallback);
}        

二.Browser檢查Client是否已經安裝AIR執行環境
var result:String=airSWF.getStatus();
取得回傳值
"available":可安裝但尚未安裝。
"unavailable":無法安裝
"installed":已安裝

三.Browser檢查Client端是否已經安裝AIR 應用程式
利用檢查AIR應用程式版本來確認程式是否已經安裝,執行後,若檢查完成
會呼叫執行所設定的versionDetectCallback函式,並在這callBack函式內
取得版本值,當版本值為null代表未安裝程式
airSWF.getApplicationVersion(appID, pubID, versionDetectCallback);
private function versionDetectCallback(version:String):void { }    

設定參數:
appID:應用程式ID,即AIR應用程式的application.xml內的id值,或在air內透過
    NativeApplication.nativeApplication.applicationID取得
pubID:發佈者ID,在air內透過
    NativeApplication.nativeApplication.publisherID取得

注意:要讓這功能有效可以使用,在使用air.swf一定要是載入http://airdownload.adobe.com/air/browserapi/air.swf
若將這air.swf複製到local端呼叫使用,則取得版本永遠會是null值

四.Browser安裝AIR App
airSWF.installApplication(installPath, runtimeVersion, arguments); 
設定參數:
installPath:String,要安裝的air檔案路徑
runtimeVersion:String,允許執行的AIR Runtime最低版本,例如"1.5"
arguments:Array,非必填項目,要傳遞給AIR的參數,這參數會被AIR內的
BrowserInvokeEvent.BROWSER_INVOKE事件所接收

五.Browser 啟動已安裝AIR APP
airSWF.launchApplication(appID, pubID, myArguments);

六.Browser傳遞參數給AIR App
airSWF.launchApplication(appID, pubID, myArguments);
只要將傳遞的參數放到myArguments陣列內即可

2010年10月1日 星期五

Air File實體檔案路徑

在開發AIR專案,如果需要利用File對使用者端做檔案存取
取得需要的實體檔案路徑,需要透過File的static變數來取得
以下是各變數所對應在Windows下的實體檔案位置

1.File.userDirectory:使用者目錄
C:\Documents and Settings\username

2.File.applicationDirectory:AIR APP執行檔所在路徑
D:\MyAirApp
3.File.applicationStorageDirectory:使用者本機可供該AIR應用程式,儲存資料的路徑
C:\Documents and Settings\username\Application Data\MyAirApp\Local Store

4.File.desktopDirectory:使用者桌面
C:\Documents and Settings\username\桌面

5.File.documentsDirectory:使用者我的文件資料夾
C:\Documents and Settings\username\My Documents

2010年4月22日 星期四

FlashDevelop 上發布Air Project相關事項

一.設定讓FlashDevelop Air API Auto Complete
    在Project Properties/compiler Option/SWC Include Lib
    加入air swc的路徑
    C:\Program Files\Adobe\Adobe Flash CS4\AIK1.5\frameworks\libs\air\airglobal.swc
    C:\Program Files\Adobe\Adobe Flash CS4\AIK1.5\frameworks\libs\air\servicemonitor.swc

二.產生AIR
1.當設定的Project為AIR
   在Project目錄下會有兩個bat檔CreateCertificate.bat與PackageApplication.bat
2.CreateCertificate.bat 產生認證檔
    編輯
   1.設定Flex SDK路徑
      set PATH=%PATH%;C:\flex_sdk_4\bin
   2.設定這認證pfx檔案的,名字,密碼與輸出檔名
set NAME=MyName
set PASSWORD=MyPassword
set CERTIFICATE=MyName.pfx
這在產生air檔案時,會需要這帳號密碼確認
   3.修改完,執行,即會產生一個pfx檔
3.PackageApplication.bat 封裝AIR
    編輯
    1.設定Flex SDK路徑
set PATH=%PATH%;C:\flex_sdk_4\bin
    2.指定要使用的數位認證檔
       set CERTIFICATE=MyName.pfx
    3.設定要輸出的檔案路徑
       set AIR_FILE=air/FlexTest1.air
    4.執行,即產生AIR檔
4.注意
  若在封裝AIR檔案發生錯誤
  如application.xml error 102:invaid namespace
  請確認,系統安裝的AIRSDK版本,與application.xml
  namespace設定的版本是否相符

三.發布到網頁
1.下載 Badge Sample
Adobe Badge Sample
http://download.macromedia.com/pub/developer/air/badge_install_samples.zip
2.修改網頁參數
   1.flaVar參數
appname:AIR App名稱(需URL encode,也就是經過escape過)
appurl:要下載的air檔案網址
airversion:要跑這個air的 runtime版本需求
imageurl:(非必填)要放到badge內的圖片路徑
buttoncolor:(非必填)按鈕顏色,預設為000000
messagecolor:(非必填)訊息文字顏色,預設為000000

   2.<noscript>內放當不支援flash player時,要提供顯示的文字連結內容

3.手動讓Web Server認得AIR檔案
  在Apache 的http.conf 加入
  <IfModule>
   AddType application/vnd.adobe.air-application-installer-package+zip .air
   </IfModule>
4.若使用Flash Player Detection Kit,可以讓使用者在站上就直接更新flash player
http://www.adobe.com/products/flashplayer/download/detection_kit/
5.執行程序
在網站上點badge安裝時
系統會先檢查,是否有Air RunTime,如果沒有會自動安裝下載
結束後,自動安裝應用程式
若已經安裝過,會檢查版本是否有更新過,如無,則可直接開啟程式
若有新版,則會安裝新版本
6.資料來源
http://www.adobe.com/devnet/air/articles/air_badge_install.html

四.安裝AIR runtime到Ubuntu上
1.下載
     http://airdownload.adobe.com/air/lin/download/1.5/AdobeAIRInstaller.bin
2.設定為可執行檔
     chmod +x AdobeAIRInstaller.bin
3.安裝
     sudo ./AdobeAIRInstaller.bin

五.AIR 自動Update機制
1.AIR Project的Application.xml內設定了這個app的版本
   安裝到client上,client上以這作為已安裝版本依據
2.在發布新的air更新檔,同時要放置一個updateInfo.xml到網站上
   當作一個版本比對的參考,只要有更新AIR版本,就要修改這份XML內容
<?xml version="1.0" encoding="utf-8"?>
<update xmlns="http://ns.adobe.com/air/framework/update/description/1.0">
<version>1.0</version>
            <url>http://192.168.11.80/air/myApp.air</url>
    <description>
  <text xml:lang="en_US">AIR AutoUpdate</text>
  <text xml:lang="zh_TW">AIR 自動更新</text>
  </description>
</update>
3.當使用者在執行其已安裝的app時,會去連線檢查
server上updateInfo.xml內的版本跟本機的是否一致
如有新版,則自動更新
4.所以,在你的AIR App程式內
需要利用ApplicationUpdater 這Class來載入Server上的updateInfo.xml
讀取版本資料來做比對,並做更新下載




六.另外需要注意的是,在FlashDevelop上開啟AIR Project在Property OutPut的設定上,需使用預定的Run Custom Command,也就是執行
C:\flex_sdk_4.1\bin\adl.exe;application.xml bin
如果只是當作一般SWF輸出到Tab上,AIR相關API會失效