Cordova SMS 插件使用教程

Cordova SMS 插件使用教程

cordova-sms-pluginCross-platform plugin for Cordova / PhoneGap to send SMS. Available for Android, iOS, and Windows Phone 8.项目地址:https://gitcode.com/gh_mirrors/co/cordova-sms-plugin

1. 项目的目录结构及介绍

cordova-sms-plugin/
├── docs/
├── src/
│   ├── android/
│   ├── ios/
│   └── windows/
├── www/
├── .gitignore
├── README.md
├── package.json
└── plugin.xml

• docs/: 包含项目的文档文件。
• src/: 包含各个平台的源代码文件。
  • android/: Android 平台的源代码。
  • ios/: iOS 平台的源代码。
  • windows/: Windows 平台的源代码。
• www/: 包含插件的公共 JavaScript 接口。
• .gitignore: Git 忽略文件配置。
• README.md: 项目说明文档。
• package.json: 项目依赖和脚本配置。
• plugin.xml: 插件的配置文件。

2. 项目的启动文件介绍

项目的启动文件主要位于 www/ 目录下，包含插件的公共 JavaScript 接口。以下是主要的启动文件：

• www/sms.js: 提供了插件的主要功能接口，如发送短信、列出短信等。

// www/sms.js 示例代码
var exec = require('cordova/exec');

var SMS = {
    send: function (number, message, successCallback, errorCallback) {
        exec(successCallback, errorCallback, "SMS", "send", [number, message]);
    },
    list: function (filter, successCallback, errorCallback) {
        exec(successCallback, errorCallback, "SMS", "list", [filter]);
    }
};

module.exports = SMS;

3. 项目的配置文件介绍

• plugin.xml: 插件的配置文件，定义了插件的名称、版本、依赖等信息。

<!-- plugin.xml 示例代码 -->
<?xml version="1.0" encoding="UTF-8"?>
<plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
    id="cordova-plugin-sms"
    version="1.0.0">
    <name>SMS</name>
    <js-module name="sms" src="www/sms.js">
        <clobbers target="SMS" />
    </js-module>
    <platform name="android">
        <config-file target="res/xml/config.xml" parent="/*">
            <feature name="SMS">
                <param name="android-package" value="com.cordova.plugin.sms.SMS"/>
            </feature>
        </config-file>
        <source-file src="src/android/SMS.java" target-dir="src/com/cordova/plugin/sms"/>
    </platform>
    <platform name="ios">
        <config-file target="config.xml" parent="/*">
            <feature name="SMS">
                <param name="ios-package" value="CDVSMS"/>
            </feature>
        </config-file>
        <source-file src="src/ios/CDVSMS.m" />
    </platform>
    <platform name="windows">
        <config-file target="config.xml" parent="/*">
            <feature name="SMS">
                <param name="windows-package" value="SMSSender"/>
            </feature>
        </config-file>
        <source-file src="src/windows/SMSSender.cs" />
    </platform>
</plugin>

• package.json: 定义了项目的依赖和脚本配置。

{
  "name": "cordova-plugin-sms",
  "version": "1.0.0",
  "description": "A Cordova plugin to send SMS messages.",
  "cordova": {
    "id": "cordova-plugin-sms",
    "platforms": [
      "android",
      "ios",
      "windows"
    ]
  },
  "keywords": [
    "ecosystem:cordova",
    "cordova-android",
    "cordova-ios",
    "cordova-windows"
  ],
  "author": "Your Name",
  "license": "Apache-2.0"
}

以上是 Cordova SMS 插件的基本使用教程，

cordova-sms-pluginCross-platform plugin for Cordova / PhoneGap to send SMS. Available for Android, iOS, and Windows Phone 8.项目地址:https://gitcode.com/gh_mirrors/co/cordova-sms-plugin