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