BlackBerry 应用程序开发者指南 第一卷:基础--附录:.alx文件的格式


作者:Confach 发表于2006-04-28 21:51
版权信息:可以任意转载, 转载时请务必以超链接形式标明文章原始出处 和作者信息.
http://www.cnblogs.com/confach/articles/387921.html

A

附录:.alx文件的格式

.alx 文件

.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 reau

           </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>标记.为获得更多信息,参看185页的”.alx文件的元素


:.带有一个嵌套模块的应用程序.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

 

 

 

 

 

java

radio

langid

color

fileset元素包含了一个可选的directory元素以及一个或多个files元素.它在一个单独的目录中指定一组.cod文件加载到BlackBerry设备中.为了加载多个目录下的文件,.alx文件中包含一个或多个fileset元素.

 

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

 

radio属性允许你加载不同的应用程序或模块.这些程序或模块依赖BlackBerry设备的网络类型.可能的值有Mobitex,DataTAC,GPRS,CDMAIDEN.radio属性是可选的.

 

langid 属性允许你加载不同的应用程序或模块.这些程序或模块依赖用户增加到BlackBerry设备的支持的语言. langid属性为此信息应用的语言指定Win32 langid语言代码.例如,一些Win32

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

 

color属性允许你为彩色或黑白屏幕加载不同的应用程序或模块.它是一个Boolean;true代表彩色,false代表黑白.

directory

-

directory元素提供了文件的位置. directory元素是可选的.如果你没有指定directory元素.文件必须和.alx文件的目录相同.指定.alx文件位置的目录.

files

-

files为应用程序提供单个目录下的一个或多个.cod文件列表,加载它们到BlackBerry设备.


[1]按照个人经验,JDE生成的ALX并不是很理想,特别是比较复杂的工程。所以对于稍微复杂的工程来说,应该手工编辑。译者注。

posted @ 2006-04-28 21:51  张太国  阅读(6036)  评论(0编辑  收藏