WeX5插件应用指南：从安装到实战

"该文档是关于WeX5的插件应用教程，主要讲解了如何使用本地插件（Cordovaplugin），并列举了电话簿/contacts插件的使用示例。" WeX5是一个混合模式的网页制作框架，它的底层技术基于cordova/phonegap，这使得开发者可以方便地开发和使用本地插件。对于BeX5，这个教程同样适用，因为BeX5是基于WeX5构建的。 ### 第一节 插件概述 在WeX5中使用本地插件，开发者需要遵循Cordova/PhoneGap的插件规范。当需要使用特定插件时，可以在页面对应的JavaScript代码中引入。比如，若要使用二维码扫描插件barcodescanner，你需要按照插件的文档来编写相应的JavaScript代码。 ### 插件列表与使用 插件通常位于`studio.exe`（即IDE工具）的`Native/plugins`文件夹下，每个插件都有一个唯一的“调用名称”，用于JavaScript调用。如果插件需要参数，这些参数需要在打包APP时填写。同时，每个插件的详细使用说明通常在插件的`xdoc`文件中，开发者应查阅这些文档以了解具体的使用方法。 ### 第二节 电话簿/Contacts插件 电话簿/Contacts插件允许开发者读取和显示电话簿信息，并提供了详细的接口调用说明。使用这个插件，可以通过Cordova插件与设备的联系人API交互。 #### 引用插件 在Wex5中，引用插件有两个主要目的：一是打包应用时无需手动添加插件；二是编码时能提供代码提示。引用插件的语法是`require("cordova!插件id")`，其中的`插件id`在插件的`plugin.xml`文件中定义。例如，对于`cordova-plugin-contacts`插件，其`id`就是`"cordova-plugin-contacts"`。 插件提供的主要命令包括： - `navigator.contacts.create()`: 新建联系人对象。 - `navigator.contacts.save()`: 保存或更新联系人信息到设备。 - `navigator.contacts.find(fields, contactfindSuccess, contactfindError, options)`: 查找联系人，根据指定字段筛选。 - `navigator.contacts.remove()`: 删除联系人。 通过这些接口，开发者可以实现对设备联系人的增删查改操作。在实际应用中，需要结合具体的业务逻辑和用户交互来使用这些API。 WeX5插件应用的教程为开发者提供了清晰的指导，从基本的插件引入到具体插件如电话簿/Contacts的使用，帮助开发者充分利用WeX5的特性来构建功能丰富的移动应用。