# cordova-plugin-WhiteBirdUP

**Repository Path**: dhcapp/cordova-plugin-WhiteBirdUP

## Basic Information

- **Project Name**: cordova-plugin-WhiteBirdUP
- **Description**: 基于友盟的推送功能
- **Primary Language**: Objective-C
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2016-11-07
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

---
title: WhiteBirdUP
description: 基于友盟的推送功能,并且扩展方法,加入了可以通过原生接受推送触发掉用js的方式
date: 2016/11/7
---
支持平台:ios

-------------------------------------------------------------------- 插件的集成步骤 --------------------------------------------------------------------

1.配置插件中的相应参数
  配置插件中plugin.xml文件中 m23下的 WBP_UMENG_APPID 或称之为友盟appkey
2.将cordova-plugin-WhiteBirdUP文件加添加到工程路径下。
3.执行 ionic plugins add cordova-plugin-WhiteBirdUP安装插件。
4.执行 ionic build ios 
5.设置Xcode Capabilities->Push Notifications->开关打开
  
-------------------------------------------------------------------- 特殊事项 --------------------------------------------------------------------  

1.在集成插件之前的重要需要为,app 的bundle id,已经相关联的推送证书,此二者不可出现问题,工程示例中,使用的为顺逛项目的测试证书,已经配置到WhiteBird友盟账号的应用推送设置中
  可通过id com.UmengP.des进行测试。如需测试可通过邮箱告知。
2.关于app bundle id 以及推送证书的配置请查阅友盟官方推送文档
3.在使用js监听回调功能时,注意插件的方法尽量使用递归掉用的形式,否则,仅仅可以检测一次。
          
-------------------------------------------------------------------- 插件方法 --------------------------------------------------------------------      

/*
 * 对推送设备添加推送标签
 */
whiteBird.addTag = function (tags, successCallback, errorCallback) {
  exec(successCallback, errorCallback, "WhiteBirdPluginUP", "addTag", [tags]);
};
/*
 * 移除推送设备的推送标签
 */
whiteBird.removeTag = function (tags, successCallback, errorCallback) {
  exec(successCallback, errorCallback, "WhiteBirdPluginUP", "removeTag", [tags]);
};
/*
 * 获取推送设备的标签列表
 */
whiteBird.getTags = function (successCallback, errorCallback) {
  exec(successCallback, errorCallback, "WhiteBirdPluginUP", "getTags", []);
};
/*
 * 移除设备所有的推送标签
 */
whiteBird.removeAllTags = function (successCallback, errorCallback) {
  exec(successCallback, errorCallback, "WhiteBirdPluginUP", "removeAllTags", []);
};
/*
 * 对推送设备添加别名
 */
whiteBird.addAlias = function (alias,type,successCallback, errorCallback) {
  exec(successCallback, errorCallback, "WhiteBirdPluginUP", "addAlias", [alias,type]);
};
/*
 * 设置推送设备的别名,如果已经设置了别名,此方法会覆盖老的
 */
whiteBird.setAlias = function (alias,type,successCallback, errorCallback) {
  exec(successCallback, errorCallback, "WhiteBirdPluginUP", "setAlias", [alias,type]);
};
/*
 * 移除设备的推送别名
 */
whiteBird.removeAlias = function (alias,type,successCallback, errorCallback) {
  exec(successCallback, errorCallback, "WhiteBirdPluginUP", "removeAlias", [alias,type]);
};
/*
 * 对推送设备绑定渠道,默认为 App store
 */
whiteBird.setChannel = function (channel) {
  exec(null, null, "WhiteBirdPluginUP", "setChannel", [channel]);
};
/*
 * 获取推送成功之后的掉用js方法,因为cordova回调方法具有一对一的性质,使用时建议采用递归方式
 */
whiteBird.getPushBack = function (successCallback) {
  exec(successCallback, null, "WhiteBirdPluginUP", "getPushBack",[]);
};




相关文档链接:http://dev.umeng.com/push/ios/integration