应用程序加载工具是BlackBerry桌面软件的一部分,它使用了一个应用程序加载文件(.alx)将应用程序加载到BlackBerry设备中去.利用BlackBerry IDE为你的工程生成一个.alx文件.

下面提供的信息只作为辅助参考.大多数情况下,你没有必要编辑BlackBerry IDE生成的.alx文件1

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

例:.alx文件样例

 
 
 
 
     
 
       Sample Network Application 
 
       Retrieves a sample page over HTTP connection. 
 
       1.0 
 
       Research In Motion 
 
       Copyright 1998-2003 Research In Motion 
 
        
 
           Application D'閏hantillon 
 
           Obtenir une page du r閟eau  
 
            
 
        
 
        
 
           samples/httpdemo 
 
            
 
             net_rim_httpdemo.cod  
 
             net_rim_resource.cod  
 
             net_rim_resource__en.cod  
 
             net_rim_resource__fr.cod  
 
 
 
        
 
     
 
 

嵌套模块

在.alx文件中创建一个嵌套的结构为应用程序提供可选的组件.一般来说,嵌套模块提供的可选特性并不适合所有用户.用户可以选择是否安装这些可选模块.

嵌套，为基本应用程序的嵌套模块创建一个隐含的依赖.为了定义一个对其他应用程序或库的显式依赖,使用标记.

例:.带有一个嵌套模块的应用程序.alx文件样例

  
 
      
 
       Sample Contacts Application  
 
       Provides the ability to store a list of contacts.  
 
  
 
       1.0  
 
       Research In Motion  
 
       Copyright 1998-2001 Research In Motion  
 
         
 
           samples/contacts  
 
                    
 
                     net_rim_contacts.cod  
 
                     net_rim_resource.cod  
 
                     net_rim_resource__en.cod  
 
                     net_rim_resource__fr.cod  
 
                     
 
         
 
         
 
           Sample Module for Contacts E-Mail Integration  
 
           Provides the ability to access the messaging application  
 
           1.0  
 
           Research In Motion  
 
           Copyright 1998-2001 Research In Motion  
 
             
 
              samples/contacts  
 
                
 
                  net_rim_contacts_mail.cod  
 
                
 
             
 
         
 
      
 
  

指定一个BlackBerry设备版本

使用了指定版本的手持设备软件中的API的应用程序,应该使用_blackBerryVersion属性来指定支持的BlackBerry设备版本.

使用下面的规则指定一个范围:

方括号[]描述闭合范围匹配

圆括号()描述开合范围匹配.

缺少低围代表0.

缺少高围代表无限值.

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

下面的例子阻止模块加载4.0版本以前的手持设备软件.

" _blackberryVersion="[4.0,)">  
 
...  
 
  
 
下面的例子为不同版本的手持设备软件提供了可选的模块.  
 
">  
 
...  
 
  
 
... modules for handheld software versions earlier than 4.0 
 
  
 
  
 
... modules for handheld software versions 4.0 and later  
 
  
 
  

.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元素隐藏包,以至在应用程序加载器里对用户不可见.增加下面的行:

true

缺省的,它和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设备时,所有指定的包也被加载.

(注: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