BlackBerry應用開發者指南基礎附錄 .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
id
application元素為單個應用程序包含了元素.
application元素也可以包含附加嵌套的application元素.嵌套使你需要:當一個應用程序加載時,它的先決條件模塊也被加載.
id屬性為應用程序指定了一個***標記符.為了***性,使用一個包含你公司域名的ID例如,com.rim.samples.docs.helloworld.
library
id
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元素隱藏包,以至在應用程序加載器里對用戶不可見.增加下面的行:
<hidden>true</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
id
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并不是很理想，特別是比較復雜的工程。所以對于稍微復雜的工程來說，應該手工編輯。）
【編輯推薦】
