BlackBerry應用開發者指南基礎附錄 .alx文件

作者：樂雨天 2011-04-13 14:10:27

本文將介紹《BlackBerry應用開發者指南》的基礎附錄 .alx文件。應用程序加載工具是BlackBerry桌面軟件的一部分,它使用了一個應用程序加載文件(.alx)將應用程序加載到BlackBerry設備中去.利用BlackBerry IDE為你的工程生成一個.alx文件.

應用程序加載工具是BlackBerry桌面軟件的一部分,它使用了一個應用程序加載文件(.alx)將應用程序加載到BlackBerry設備中去.利用BlackBerry IDE為你的工程生成一個.alx文件.

下面提供的信息只作為輔助參考.大多數情況下,你沒有必要編輯BlackBerry IDE生成的.alx文件1

在文本編輯器里,你可以編輯BlackBerry IDE生成的.alx文件..alx文件使用XML格式:

例:.alx文件樣例

<?xml version="1.0" encoding="UTF-8"?> 
 
<loader version="1.0"> 
 
    <application id="com.rim.samples.device.httpdemo"> 
 
       <name>Sample Network Application</name> 
 
       <description>Retrieves a sample page over HTTP connection.</description> 
 
       <version>1.0</version> 
 
       <vendor>Research In Motion</vendor> 
 
       <copyright>Copyright 1998-2003 Research In Motion</copyright> 
 
       <language langid="0x000c"> 
 
           <name>Application D'閏hantillon</name> 
 
           <description>Obtenir une page du r閟eau  
 
           </description> 
 
       </language> 
 
       <fileset Java="1.0"> 
 
           <directory>samples/httpdemo</directory> 
 
           <files> 
 
             net_rim_httpdemo.cod  
 
             net_rim_resource.cod  
 
             net_rim_resource__en.cod  
 
             net_rim_resource__fr.cod  
 
</files> 
 
       </fileset> 
 
    </application> 
 
</loader>

嵌套模塊

在.alx文件中創建一個嵌套的結構為應用程序提供可選的組件.一般來說,嵌套模塊提供的可選特性并不適合所有用戶.用戶可以選擇是否安裝這些可選模塊.

嵌套，為基本應用程序的嵌套模塊創建一個隱含的依賴.為了定義一個對其他應用程序或庫的顯式依賴,使用<requires>標記.

例:.帶有一個嵌套模塊的應用程序.alx文件樣例

<loader version="1.0">  
 
    <application id="net.rim.sample.contacts">  
 
       <name>Sample Contacts Application</name>  
 
       <description>Provides the ability to store a list of contacts.  
 
</description>  
 
       <version>1.0</version>  
 
       <vendor>Research In Motion</vendor>  
 
       <copyright>Copyright 1998-2001 Research In Motion</copyright>  
 
       <fileset Java="1.0">  
 
           <directory>samples/contacts</directory>  
 
                  <files>  
 
                     net_rim_contacts.cod  
 
                     net_rim_resource.cod  
 
                     net_rim_resource__en.cod  
 
                     net_rim_resource__fr.cod  
 
                   </files>  
 
       </fileset>  
 
       <application id="net.rim.sample.contacts.mail">  
 
           <name>Sample Module for Contacts E-Mail Integration</name>  
 
           <description>Provides the ability to access the messaging application</description>  
 
           <version>1.0</version>  
 
           <vendor>Research In Motion</vendor>  
 
           <copyright>Copyright 1998-2001 Research In Motion</copyright>  
 
           <fileset Java="1.0">  
 
              <directory>samples/contacts</directory>  
 
              <files>  
 
                  net_rim_contacts_mail.cod  
 
              </files>  
 
           </fileset>  
 
       </application>  
 
    </application>  
 
</loader>

指定一個BlackBerry設備版本

使用了指定版本的手持設備軟件中的API的應用程序,應該使用_blackBerryVersion屬性來指定支持的BlackBerry設備版本.

使用下面的規則指定一個范圍:

方括號[]描述閉合范圍匹配

圓括號()描述開合范圍匹配.

缺少低圍代表0.

缺少高圍代表無限值.

例如,[4.0,)代表4.0和無限大之間的任何版本.

下面的例子阻止模塊加載4.0版本以前的手持設備軟件.

<application id="<application_id>" _blackberryVersion="[4.0,)">  
 
...  
 
</application>  
 
下面的例子為不同版本的手持設備軟件提供了可選的模塊.  
 
<application id="<application_id>">  
 
...  
 
<fileset _blackBerryVersion="(,4.0)">  
 
... modules for handheld software versions earlier than 4.0 
 
</fileset>  
 
<fileset _blackBerryVersion="[4.0,)">  
 
... modules for handheld software versions 4.0 and later  
 
</fileset>  
 
</application>

.alx文件元素

元素

屬性

描述

loader

version

loader包含了一個或多個applicaiton元素

version屬性指定了應用程序加載器的版本.

applicaiton

application元素為單個應用程序包含了元素.

application元素也可以包含附加嵌套的application元素.嵌套使你需要:當一個應用程序加載時,它的先決條件模塊也被加載.

id屬性為應用程序指定了一個***標記符.為了***性,使用一個包含你公司域名的ID例如,com.rim.samples.docs.helloworld.

library

Library代替application標簽

name

name為應用程序提供了一個描述性的名稱.這個名稱在應用程序加載器中顯示.它不會在BlackBerry設備中顯示.

description

description元素為應用程序提供了一個簡短的描述.本描述在應用程序加載器中顯示.它不會在BlackBerry設備中顯示.

version

version元素為應用程序提供了一個版本號.它在應用程序加載器中顯示.版本號僅為顯示信息而用.

vendor

vendor元素提供創建應用程序的公司名,它在應用程序加載器中顯示.

copyright

copyright元素提供版權信息, 它在應用程序加載器中顯示..

required

required允許你強制加載一個應用程序.在應用程序加載器里,選擇一個應用程序安裝.加入下面的行:

< required>true< required>

required標記僅由企業系統管理員使用.它不為第三方應用程序的用戶使用.

注:BlackBerry桌面軟件3.6或后期版本支持本元素.

hidden

hidden元素隱藏包,以至在應用程序加載器里對用戶不可見.增加下面的行:

缺省的,它和required元素聯合起來加載應用程序.或如果一個應用程序已加載,設置required標記來加載此包.

hidden標記僅由企業系統管理員使用.它不為第三方應用程序的用戶使用.

注:BlackBerry桌面軟件3.6或后期版本支持本元素.

language

langid

當應用程序加載器以langid屬性指定的語言運行時,language標記允許你覆寫在應用程序顯示的文本.

為了支持多語言,指定多個language標記.為了指定每種語言的name(名稱),version(版本),vendor(發行商)以及copyright(版權),在language標簽里嵌套他們.如果不沒有嵌套一個標記,將以缺省的語言顯示.

langid屬性為此信息應用的語言指定Win32 langid語言代碼.例如,一些Win32 langid代碼是:0x0009(英語),0x0007(德語),0x000a(西班牙語),0x00c(法語).

requires

requires元素可選,它指定了應用程序依賴的包的id.如果一應用程序依賴不止一其他的應用程序,id可以不止一次出現.

當一個應用程序加載到BlackBerry設備時,所有<requires>指定的包也被加載.

(注:BlackBerry桌面軟件3.6或后期版本支持本元素.)

fileset

fileset元素包含了一個可選的directory元素以及一個或多個files元素.它在一個單獨的目錄中指定一組.cod文件加載到BlackBerry設備中.為了加載多個目錄下的文件,在.alx文件中包含一個或多個fileset元素.

Java

Java屬性指定.cod文件兼容的BlackBerry Java VM最小版本,當前的VM版本是版本1.0.Java屬性是必需的.

radio

radio屬性允許你加載不同的應用程序或模塊.這些程序或模塊依賴BlackBerry設備的網絡類型.可能的值有Mobitex,DataTAC,GPRS,CDMA和IDEN.radio屬性是可選的.

langid

langid 屬性允許你加載不同的應用程序或模塊.這些程序或模塊依賴用戶增加到BlackBerry設備的支持的語言. langid屬性為此信息應用的語言指定Win32 langid語言代碼.例如,一些Win32

langid代碼是:0x0009(英語),0x0007(德語),0x000a(西班牙語),0x00c(法語).

color

color屬性允許你為彩色或黑白屏幕加載不同的應用程序或模塊.它是一個Boolean值;true代表彩色,false代表黑白.

directory

directory元素提供了文件的位置. directory元素是可選的.如果你沒有指定directory元素.文件必須和.alx文件的目錄相同.指定.alx文件位置的目錄.

files

files為應用程序提供單個目錄下的一個或多個.cod文件列表,加載它們到BlackBerry設備.

（譯者注：按照個人經驗，JDE生成的ALX并不是很理想，特別是比較復雜的工程。所以對于稍微復雜的工程來說，應該手工編輯。）

【編輯推薦】

BlackBerry應用開發者指南使用受控API
BlackBerry應用開發者指南 Mail API
BlackBerry應用開發者指南 PIM API
BlackBerry應用開發者指南選項API

責任編輯：佚名來源： 10086

.alx文件 BlackBerry