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并不是很理想，特别是比较复杂的工程。所以对于稍微复杂的工程来说，应该手工编辑。）

【编辑推荐】

1. BlackBerry应用开发者指南 使用受控API
2. BlackBerry应用开发者指南 Mail API
3. BlackBerry应用开发者指南 PIM API
4. BlackBerry应用开发者指南 选项API