B4X编程语言:B4X的库(Libraries)
B4X编程语言:B4X的库(Libraries)
B4X的库是B4X的基本组件之一,它向B4X添加了更多的对象和功能。B4X的库分两类:一类是标准库,是随B4X产品一起附带的,是标准开发系统的一部分。另一类是用户开发的库(包括自己开发的库),称为附加库(或额外库),可以从B4X主站下载,为B4X开发环境添加补充功能。
一、库的位置
1、标准库
标准库一般保存在B4X程序文件夹中的Libraries文件夹中。通常为:
- C:\Program Files\Anywhere Software\B4A\Libraries
- C:\Program Files\Anywhere Software\B4i\Libraries
- C:\Program Files\Anywhere Software\B4J\Libraries
- C:\Program Files\Anywhere Software\B4R\Libraries
2、附加库(额外库)
附加库有两种类型,一种由两个文件组成:一个xxx.jar文件和一个xxx.xml文件。一种是B4X库,只有一个文件xxx.b4xlib。
对于附加库,需要设置一个特殊的文件夹来将它们保存到其他地方。此文件夹必须具有以下结构:
- B4A附加库的文件夹。
- B4i附加库的文件夹。
- B4J附加库的文件夹。
- B4R附加库的文件夹。
- B4X库的文件夹。
- 代码片段的文件夹。
- B4X文件夹中的一个子文件夹。
- B4X库的XML文件的文件夹
设置好附加库存放位置后,需要在IDE的工具>配置路径窗口指定附加库路径,如下图:
具体填写的位置视您设置的存放位置而定。下载好库文件后,将库文件放到相应的文件夹中。如果是B4X库,就放到B4X文件夹中。IDE的库管理器将自动添加该库,在库选项卡中将会看到该库。
二、库的使用
B4X是一种模块化编程语言,对库的引用很方便。您的项目需要哪个库,就通过库选项卡选取添加哪个库。
B4X的IDE中,我们可以很方便地通过库管理器的库选项卡查看已有哪些库,项目已经选择了哪些库。如下图:
如果您的项目需要需要一个库,就在此选项卡中检查:
如果选项卡中已存在该库,您需要做如下工作:
1、如果是标准库,就直接选中它,因为标准库是自动更新的,它已是最新版本。
2、如果是额外库,请检查它是否是最新版本。是最新版本就直接选中它,不是最新版本,就下载最新版本后替换原来版本,重新在选项卡选取它。
您可以在文档页面B4A,B4i,B4J,B4R 中查看版本或在论坛中的Libraries Google 表格中查看。要查找库文件,请在您的互联网浏览器中使用类似http://www.b4x.com/search?query=betterdialogs+library的查询。
如果选项卡中没有该库,请下载该库。
下载后解压缩并将
B4X的每个平台都有一个附加库的子文件夹: B4A、B4i、B4J、B4R和另一个用于B4X库的B4X。在安装新版本的B4X时,所有标准库都会自动更新,但不包括附加库(额外库)。这个特殊的文件夹的优点是你不需要关注它们,因为在您安装新版本的B4X时,此文件夹不会受到影响。额外库没有系统地使用新版本的B4X进行更新。
当IDE启动时,它首先在B4X的标准库文件夹中查找可用的库,然后再在额外库文件夹中查找。
标准库和额外库都有一个XML文件。B4X库则没有。
您可以使用以下工具为b4xlib库创建xml文件:b4xlib - XML generation。
三、B4X库 *.b4xlib
B4X库是在B4A 8.80、B4i 5.50和B4J 7.00中引入的跨平台库。这些库包含跨平台类,无需编译为库。
B4X库是一个简单的zip文件,其结构如下:
- 代码模块。支持所有类型,包括活动和服务。
- Files文件夹。包括布局文件。
- 包含以下字段的可选清单文件:
- 版本
- 作者
- DependsOn依赖项(所需库的列表),支持的平台。字段可以在平台之间共享,也可以是特定于平台的。
- 代码片段文件夹,其中包含特定库的代码片段。
文件和代码模块也可以是特定于平台的。
创建b4x库非常简单。您只需要使用这些资源创建一个zip文件。zip文件的扩展名为b4xlib。请注意,源代码可以从b4x库中提取。
b4x库与所有其他库一样出现在“库”选项卡中。
例如: AnotherDatePicker.b4xlib
zip文件结构:
Files文件夹包含所有所需的文件,即示例中的三个布局文件。
AnotherDatePicker.bas是一个跨平台的自定义视图文件。
Manifest.txt 包含版本号和该库在不同平台下所依赖的其它库。内容如下:
Version=2.00
B4J.DependsOn=jXUI, jDateUtils
B4A.DependsOn=XUI, DateUtils
B4i.DependsOn=iXUI, iDateUtils
将xxx.b4xlib文件复制到额外库\B4X文件夹中。
如果有xxx.xml文件,则不能将其保存在那里,而应保存在另一个文件夹中。
四、加载和更新库
官方库和额外库的相关帮助文档列表可以在B4X网站上找到:
- B4A 文档页面:List of Libraries.
- B4i 文档页面:List of Libraries.
- B4J 文档页面:List of Libraries.
- B4R 文档页面:List of Libraries.
或者在B4X Libraries Google sheet。
要找到库文件,请在互联网浏览器中使用像
http://www.b4x.com/search?query=betterdialogs+library这样的查询。
要加载或更新库,请执行以下步骤:
- 下载某个库zip文件。
- 解压。
- 复制xxx.jar和xxx.xml文件到附加库文件夹,如果是B4X库,则将xxx.b4xlib文件复制到B4X 库文件夹
- 在“库管理器”表中的库列表中单击鼠标右键,然后单击Refresh并选择库。
