cordova-plugin-xinstall 1.3.3 → 1.5.5

package/README.md

@@ -34,24 +34,112 @@ Android 不需要任何配置
 
 ## 调用API
 
-### 1.快速下载
+### 1. 快速下载
 
 如果只需要快速下载功能，无需其它功能（携带参数安装、渠道统计、一键拉起），完成初始化即可(这里指安装插件)
 
-### 2. 一键拉起
+### 2.初始化SDK
+
+```js
+window.xinstall.init();
+```
+
+### 3. 一键拉起
 
 #### 拉起参数获取
 
 调用以下代码注册拉起回调，应尽早调用。如在 `deviceready` 事件回调之时注册
 
 ```js
+// 第一种回调方法 只有是wakeup 操作才会回调------------
 window.xinstall.registerWakeUpHandler(function(data) {
        // 对data进行处理
 }, function(msg){
        console.log("xinstall.wakeup error : " + msg)
 });
+// -----------------------------------------------
+
+// 第二种回调方法， 只要调用方法，就一定有回调------------
+ window.xinstall.registerWakeUpDetailHandler(function(data) {
+       // 对data进行处理
+},function(msg) {
+        console.log("xinstall.registerWakeUpDetailHandler : " + msg)
+});
+//-----------------------------------------------------
+```
+
+【注】：两种回调方法选择一个使用。
+
+两种回调返回的data格式分别为：
+
+```json
+// 第一种回调的json 数据
+{
+    "channelCode":"渠道编号",  // 字符串类型。渠道编号，没有渠道编号时为 ""
+    "data":{									// 对象类型。唤起时携带的参数。
+        "co":{								// co 为唤醒页面中通过 Xinstall Web SDK 中的点击按钮传递的数据，key & value 均可自定义，key & value 数量不限制
+            "自定义key1":"自定义value1", 
+            "自定义key2":"自定义value2"
+        },
+        "uo":{   							// uo 为唤醒页面 URL 中 ? 后面携带的标准 GET 参数，key & value 均可自定义，key & value 数量不限制
+            "自定义key1":"自定义value1",
+            "自定义key2":"自定义value2"
+        }
+    }
+}
+
+// 第二种回调的json 数据
+{
+  "wakeUpData":
+  {
+    "channelCode":"渠道编号",  // 字符串类型。渠道编号，没有渠道编号时为 ""
+    "data":{									// 对象类型。唤起时携带的参数。
+        "co":{								// co 为唤醒页面中通过 Xinstall Web SDK 中的点击按钮传递的数据，key & value 均可自定义，key & value 数量不限制
+            "自定义key1":"自定义value1", 
+            "自定义key2":"自定义value2"
+        },
+        "uo":{   							// uo 为唤醒页面 URL 中 ? 后面携带的标准 GET 参数，key & value 均可自定义，key & value 数量不限制
+            "自定义key1":"自定义value1",
+            "自定义key2":"自定义value2"
+        }
+    }
+  },
+  "error": 
+  {
+    "errorType" : 7,					// 数字类型。代表错误的类型，具体数字对应类型可在下方查看
+    "errorMsg" : "xxxxx"			// 字符串类型。错误的描述
+  }
+}
+
+
+/** errorType 对照表：
+ * iOS
+ * -1 : SDK 配置错误；
+ * 0 : 未知错误；
+ * 1 : 网络错误；
+ * 2 : 没有获取到数据；
+ * 3 : 该 App 已被 Xinstall 后台封禁；
+ * 4 : 该操作不被允许（一般代表调用的方法没有开通权限）；
+ * 5 : 入参不正确；
+ * 6 : SDK 初始化未成功完成；
+ * 7 : 没有通过 Xinstall Web SDK 集成的页面拉起；
+ *
+ * Android
+ * 1006 : 未执行init 方法;
+ * 1007 : 未传入Activity，Activity 未比传参数
+ * 1008 : 用户未知操作 不处理
+ * 1009 : 不是唤醒执行的调用方法
+ * 1010 : 前后两次调起时间小于1s，请求过于频繁
+ * 1011 : 获取调起参数失败
+ * 1012 : 重复获取调起参数
+ * 1013 : 本次调起并非为XInstall的调起
+ * 1004 : 无权限
+ * 1014 : SCHEME URL 为空
+ */
 ```
 
+
+
 **iOS 由于使用Universal Link 技术**
 
 首先，我们需要到[苹果开发者网站](https://developer.apple.com/)，为当前的 App ID 开启关联域名 (Associated Domains) 服务：
@@ -62,11 +150,13 @@ window.xinstall.registerWakeUpHandler(function(data) {
 
 ![](res/2.png)
 
-在Xcode中配置Xinstall为当前应用生成的关联域名 (Associated Domains) ：**applinks:xxxx.xinstall.top**
+在Xcode中配置Xinstall为当前应用生成的关联域名 (Associated Domains) ：**applinks:xxxx.xinstall.top** 和 **applinks:xxxx.xinstall.net**
+
+> 具体的关联域名可在 Xinstall管理后台 - 对应的应用控制台 - iOS下载配置 页面中找到
 
-![](res/3.png)
+![](https://doc.xinstall.com/Cordova/res/3.png)
 
-### 3. 携带参数安装
+### 4. 携带参数安装
 
 ```js
 window.xinstall.getInstallParams(function(data) {
@@ -87,21 +177,233 @@ window.xinstall.getInstallParams(function(data) {
 // isFirstFetch 是否第一次获取安装参数
 ```
 
-### 4. 渠道统计相关
+### 5. 渠道统计相关
 
-#### 4.1 注册量统计
+#### 5.1 注册量统计
 
 ```js
 window.xinstall.reportRegister();
 ```
 
-#### 4.2 渠道效果统计
+#### 5.2 渠道效果统计
 
 ```js
 window.xinstall.reportEffectEvent(eventId, eventVal);
 ```
 
-【注】事件需要在Xinstall 后台添加
+**补充说明**
+
+只有 Xinstall 后台创建事件统计，并且代码中 **传递的事件ID** 与 **后台创建的ID** 一致时，上报数据才会被统计。
+
+### 6. 广告平台渠道功能
+
+> 如果您在 Xinstall 管理后台对应 App 中，**只使用「自建渠道」，而不使用「广告平台渠道」，则无需进行本小节中额外的集成工作**，也能正常使用 Xinstall 提供的其他功能。
+>
+> 注意：根据目前已有的各大主流广告平台的统计方式，目前 iOS 端和 Android 端均需要用户授权并获取一些设备关键值后才能正常进行 [ 广告平台渠道 ] 的统计，如 IDFA / OAID / GAID 等，对该行为敏感的 App 请慎重使用该功能。
+
+#### 6.1 配置工作
+
+**iOS 端：**
+
+在 Xcode 中打开 iOS 端的工程，在 `Info.plist` 文件中配置一个权限作用声明（如果不配置将导致 App 启动后马上闪退）：
+
+```xml
+<key>NSUserTrackingUsageDescription</key>
+<string>这里是针对获取 IDFA 的作用描述，请根据实际情况填写</string>
+```
+
+在 Xcode 中，找到 App 对应的「Target」，再点击「General」，然后在「Frameworks, Libraries, and Embedded Content」中，添加如下两个框架：
+
+* AppTrackingTransparency.framework
+* AdSupport.framework
+
+**Android 端：**
+
+  相关接入可以参考广告平台联调指南中的[《Android集成指南》](https://doc.xinstall.com/AD/AndroidGuide.html)
+
+1. 接入IMEI需要额外的全下申请，需要在`AndroidManifest`中添加权限声明
+
+   ```java
+   <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
+   ```
+
+2. 如果使用OAID，因为内部使用反射获取oaid 参数，所以都需要外部用户接入OAID SDK 。具体接入参考[《Android集成指南》](https://doc.xinstall.com/AD/AndroidGuide.html)
+
+
+
+##### 6.2、更换初始化方法
+
+**使用新的 initWithAd 方法，替代原先的 init 方法来进行模块的初始化**
+
+> iOS 端使用该方法时，需要传入 IDFA（在 JS 脚本内）。您可以使用任意方式在 JS 脚本中获取到 IDFA，例如第三方获取 IDFA 的模块。
+>
+
+**入参说明**：需要主动传入参数，字典
+
+入参内部字段：
+
+* iOS 端：
+
+  <table>
+         <tr>
+             <th>参数名</th>
+             <th>参数类型</th>
+             <th>描述 </th>
+         </tr>
+         <tr>
+             <th>idfa</th>
+             <th>字符串</th>
+             <th>iOS 系统中的广告标识符</th>
+         </tr>
+    			<tr>
+             <th>asaEnable</th>
+             <th>boolean</th>
+             <th>是否开启 ASA 渠道，不需要时可以不传。详见《8. 苹果搜索广告（ASA）渠道功能》</th>
+         </tr>
+     </table>
+
+
+* Android 端：
+
+  <table>
+            <tr>
+                <th>参数名</th>
+                <th>参数类型</th>
+                <th>描述 </th>
+            </tr>
+            <tr>
+                <th>adEnabled</th>
+                <th>boolean</th>
+                <th>是否使用广告功能</th>
+            </tr>
+    				<tr>
+                <th>oaid （可选）</th>
+                <th>string</th>
+                <th>OAID</th>
+            </tr>
+    				<tr>
+                <th>gaid（可选）</th>
+                <th>string</th>
+                <th>GaID(google Ad ID)</th>
+            </tr>
+        </table>
+
+**调用示例**
+
+```javascript
+
+  // oaid和gaid 为选传，不传则代表使用SDK自动去获取（SDK内不包括OAID SDK，需要自己接入）
+  window.xinstall.initWithAd({adEnabled:true,idfa:"idfa需要自己传入",oaid:"oaid测试",gaid:"测试",asaEnable:true});
+  // 如果希望在完成初始化，立即执行之后的步骤可以通过 下列代码实现-------------------------
+  //window.xinstall.initWithAd({adEnable:true,idfa:"外部获取的idfa",asaEnable:true},function() {
+	//		window.xinstall.getInstallParams 或者 window.xinstall.registerWakeUpHandler 等操作
+	//});
+  //-----------------------------------------------------------------------------
+
+```
+
+##### 7.3、上架须知
+
+**在使用了广告平台渠道后，若您的 App 需要上架，请认真阅读本段内容。**
+
+##### 7.3.1 iOS 端：上架 App Store
+
+1. 如果您的 App 没有接入苹果广告（即在 App 中显示苹果投放的广告），那么在提交审核时，在广告标识符中，请按照下图勾选：
+
+![IDFA](https://cdn.xinstall.com/iOS_SDK%E7%B4%A0%E6%9D%90/IDFA_7.png)
+
+
+
+1. 在 App Store Connect 对应 App —「App隐私」—「数据类型」选项中，需要选择：**“是，我们会从此 App 中收集数据”**：
+
+![AppStore_IDFA_1](https://cdn.xinstall.com/iOS_SDK%E7%B4%A0%E6%9D%90/IDFA_1.png)
+
+在下一步中，勾选「设备 ID」并点击【发布】按钮：
+
+![AppStore_IDFA_2](https://cdn.xinstall.com/iOS_SDK%E7%B4%A0%E6%9D%90/IDFA_2.png)
+
+点击【设置设备 ID】按钮后，在弹出的弹框中，根据实际情况进行勾选：
+
+- 如果您仅仅是接入了 Xinstall 广告平台而使用了 IDFA，那么只需要勾选：**第三方广告**
+- 如果您在接入 Xinstall 广告平台之外，还自行使用 IDFA 进行别的用途，那么在勾选 **第三方广告** 后，还需要您根据您的实际使用情况，进行其他选项的勾选
+
+![AppStore_IDFA_3](https://cdn.xinstall.com/iOS_SDK%E7%B4%A0%E6%9D%90/IDFA_3.png)
+
+![AppStore_IDFA_4](https://cdn.xinstall.com/iOS_SDK%E7%B4%A0%E6%9D%90/IDFA_4.png)
+
+勾选完成后点击【下一步】按钮，在 **“从此 App 中收集的设备 ID 是否与用户身份关联？”** 选项中，请根据如下情况进行选择：
+
+- 如果您仅仅是接入了 Xinstall 广告平台而使用了 IDFA，那么选择 **“否，从此 App 中收集的设备 ID 未与用户身份关联”**
+- 如果您在接入 Xinstall 广告平台之外，还自行使用 IDFA 进行别的用途，那么请根据您的实际情况选择对应的选项
+
+![AppStore_IDFA_5](https://cdn.xinstall.com/iOS_SDK%E7%B4%A0%E6%9D%90/IDFA_5.png)
+
+最后，在弹出的弹框中，选择 **“是，我们会将设备 ID 用于追踪目的”**，并点击【发布】按钮：
+
+![AppStore_IDFA_6](https://cdn.xinstall.com/iOS_SDK%E7%B4%A0%E6%9D%90/IDFA_6.png)
+
+##### 7.3.2 Android 端
+
+无特殊需要注意，如碰上相关合规问题，参考 [《应用合规指南》](https://doc.xinstall.com/应用合规指南.html)
+
+### 8. 苹果搜索广告（ASA）渠道功能
+
+>  如果您在 Xinstall 管理后台对应 App 中，**不使用「ASA渠道」，则无需进行本小节中额外的集成工作**，也能正常使用 Xinstall 提供的其他功能。
+
+#### 8.1 更换初始化方法
+
+**使用新的 initWithAd 方法，替代原先的 init 方法来进行模块的初始化**
+
+## **initWithAd**
+
+**入参说明**：需要主动传入参数，JSON对象
+
+入参内部字段：
+
+* iOS 端：
+
+  <table>
+         <tr>
+             <th>参数名</th>
+             <th>参数类型</th>
+             <th>描述 </th>
+         </tr>
+         <tr>
+             <th>idfa</th>
+             <th>string</th>
+             <th>iOS 系统中的广告标识符（不需要时可以不传）</th>
+         </tr>
+         <tr>
+             <th>asaEnable</th>
+             <th>boolean</th>
+             <th>是否开启 ASA 渠道，true 时为开启，false 或者不传时均为不开启</th>
+         </tr>
+     </table>
+
+**回调说明**：无需传入回调函数
+
+**调用示例**
+
+```javascript
+// idfa 为广告传入参数，如果未使用到，可以不传入
+window.xinstall.initWithAd({asaEnable:true},function() {
+       // 初始化回调 为选传参数
+       window.xinstall.getInstallParams(function(data){
+                
+       }, 10);
+ });
+ 
+```
+
+**可用性**
+
+iOS系统
+
+可提供的 1.5.5 及更高版本
+
+
+
+
 
 ## 导出apk/ipa包并上传
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cordova-plugin-xinstall",
-  "version": "1.3.3",
+  "version": "1.5.5",
   "description": "Xinstall 为了用户更方便的接入SDK，基于原生SDK封装的CordovaSDK",
   "cordova": {
     "id": "cordova-plugin-xinstall",

package/plugin.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" ?>
-<plugin id="cordova-plugin-xinstall" version="1.3.2"
+<plugin id="cordova-plugin-xinstall" version="1.5.5"
     xmlns="http://phonegap.com/ns/plugins/1.0"
     xmlns:android="http://schemas.android.com/apk/res/android"
     >

package/src/android/XinstallPlugin.java

@@ -1,14 +1,18 @@
 package io.xinstall.cordova;// TOM
 
 import android.app.Activity;
-import android.app.AlertDialog;
 import android.content.Intent;
+import android.os.Handler;
+import android.os.Looper;
 import android.text.TextUtils;
 import android.util.Log;
+
+import com.xinstall.XINConfiguration;
 import com.xinstall.XInstall;
 import com.xinstall.listener.XInstallAdapter;
 import com.xinstall.listener.XWakeUpAdapter;
 import com.xinstall.model.XAppData;
+import com.xinstall.model.XAppError;
 
 import org.apache.cordova.CallbackContext;
 import org.apache.cordova.CordovaArgs;
@@ -24,25 +28,31 @@ public class XinstallPlugin extends CordovaPlugin {
     public static final  String XinstallPlugin = "XinstallPlugin";
 
     private CallbackContext wakeupCallbackContext = null;
+    private XAppData wakeupAppData = null;
+    private XAppError wakeupAppError = null;
+
+    private Intent wakeupIntent = null;
+    private Activity wakeupActivity = null;
+
+    private boolean hasCallInit = false;
+    private boolean initialized = false;
+    private boolean registerWakeup = false;
+    private Integer wakeupType = 0;
 
-    private boolean isOpenYyb = false;
+    private static final Handler UIHandler = new Handler(Looper.getMainLooper());
 
     @Override
     protected void pluginInitialize() {
         super.pluginInitialize();
-        init();
+        getWakeUpParams(cordova.getActivity(),cordova.getActivity().getIntent());
     }
 
     @Override
     public void onNewIntent(Intent intent) {
         super.onNewIntent(intent);
-        if (wakeupCallbackContext != null) {
-            getWakeUpParams(cordova.getActivity(),intent, wakeupCallbackContext);
-        }
+        getWakeUpParams(cordova.getActivity(),intent);
     }
 
-
-
     @Override
     public boolean execute(String action, CordovaArgs args, CallbackContext callbackContext) throws JSONException {
         Log.d(XinstallPlugin,"execute  action =" + action);
@@ -52,56 +62,276 @@ public class XinstallPlugin extends CordovaPlugin {
         }
 
         if ("getInstallParams".equals(action)) {
-            getInstallParams(args, callbackContext);
+            runInUIThread(new Runnable() {
+                @Override
+                public void run() {
+                    getInstallParams(args, callbackContext);
+                }
+            });
             return true;
         } else if ("registerWakeUpHandler".equals(action)) {
-            registerWakeUpHandler(callbackContext);
+            runInUIThread(new Runnable() {
+                @Override
+                public void run() {
+                    registerWakeUpHandler(callbackContext);
+                }
+            });
+            return true;
+        } else if ("registerWakeUpDetailHandler".equals(action)) {
+            runInUIThread(new Runnable() {
+                @Override
+                public void run() {
+                    registerWakeUpDetailHandler(callbackContext);
+                }
+            });
             return true;
         } else if ("reportRegister".equals(action)) {
-            reportRegister(callbackContext);
+            runInUIThread(new Runnable() {
+                @Override
+                public void run() {
+                    reportRegister(callbackContext);
+                }
+            });
+
             return true;
         } else if ("reportEffectEvent".equals(action)) {
-            reportEffectEvent(args, callbackContext);
+            runInUIThread(new Runnable() {
+                @Override
+                public void run() {
+                    reportEffectEvent(args, callbackContext);
+                }
+            });
+            return true;
+        } else if ("reportShareByXinShareId".equals(action)) {
+			runInUIThread(new Runnable() {
+				@Override
+				public void run() {
+				    reportShareByXinShareId(args, callbackContext);
+				}
+			});
+			return true;
+		} else if ("initNoAd".equals(action)) {
+            runInUIThread(new Runnable() {
+                @Override
+                public void run() {
+                    initNoAd();
+                }
+            });
             return true;
-        } else if ("openYybWakeUp".equals(action)) {
-            openYybWakeUp(callbackContext);
+        } else if ("initWithAd".equals(action)){
+            runInUIThread(new Runnable() {
+                @Override
+                public void run() {
+                    initWithAd(args,callbackContext);
+                }
+            });
+			return true;
+		} else if ("setLog".equals(action)) {
+            runInUIThread(new Runnable() {
+                @Override
+                public void run() {
+                    setLog(args);
+                }
+            });
             return true;
         }
-
         return false;
     }
 
-    protected void init() {
+    private  static void runInUIThread(Runnable runnable) {
+        if (Looper.myLooper() == Looper.getMainLooper()) {
+            // 当前线程为UI主线程
+            runnable.run();
+        } else {
+            UIHandler.post(runnable);
+        }
+    }
+
+    protected void setLog(CordovaArgs args) {
+        if (args != null && !args.isNull(0)) {
+            Log.d(XinstallPlugin,"setLog");
+            boolean isOpen = args.optBoolean(0);
+            XInstall.setDebug(isOpen);
+        }
+    }
+
+    protected void initNoAd() {
+		hasCallInit = true;
         Log.d(XinstallPlugin,"init");
         XInstall.init(cordova.getContext());
+		initialized();
     }
-
-    private void getWakeUpParams(Activity activity, Intent intent, final CallbackContext callbackContext) {
-        if ((intent.getCategories() != null  && intent.getCategories().contains(Intent.CATEGORY_LAUNCHER)) && this.isOpenYyb == false) {
-            return;
+	
+	protected void initWithAd(CordovaArgs args, final CallbackContext callbackContext) {
+		hasCallInit = true;
+		Log.d(XinstallPlugin,"initWithAd");
+		boolean adEnable = false;
+		if (args != null && !args.isNull(0)) {
+			adEnable = args.optBoolean(0);
+		}
+		String oaid = "";
+		if (args != null && !args.isNull(1)) {
+		    oaid = args.optString(1);
+        }
+		String gaid = "";
+		if (args != null && !args.isNull(2)) {
+		    gaid = args.optString(2);
+        }
+		boolean isPremission = true;
+		if (args != null && !args.isNull(3)) {
+		    isPremission = args.optBoolean(3);
         }
 
-        Log.d(XinstallPlugin,"getWakeUpParams  intent : " + intent.getDataString());
-        XInstall.getWakeUpParam(activity, intent, new XWakeUpAdapter() {
-            @Override
-            public void onWakeUp(XAppData xAppData) {
-                if (xAppData != null) {
-                    JSONObject jsonObject = xAppData.toJsonObject();
+		final XINConfiguration configuration = XINConfiguration.Builder().adEnable(true);
+		if (!"".equals(gaid)) {
+		    configuration.gaid(gaid);
+        }
+        if (!"".equals(oaid)) {
+            configuration.oaid(oaid);
+        }
 
-                    PluginResult result = new PluginResult(PluginResult.Status.OK, jsonObject);
-                    result.setKeepCallback(true);
-                    callbackContext.sendPluginResult(result);
-                } else {
-                    PluginResult result = new PluginResult(PluginResult.Status.OK);
-                    result.setKeepCallback(true);
-                    callbackContext.sendPluginResult(result);
+        if (isPremission) {
+            XInstall.initWithPermission(cordova.getContext(), configuration, new Runnable() {
+                @Override
+                public void run() {
+                    initialized();
+					callbackContext.success();
                 }
+            });
+        } else {
+            XInstall.init(cordova.getContext(),configuration);
+            initialized();
+			callbackContext.success();
+        }
+	}
+
+    private void initialized() {
+        initialized = true;
+        if (wakeupIntent != null && wakeupActivity != null) {
+            if (wakeupType == 1) {
+                XInstall.getWakeUpParam(wakeupActivity, wakeupIntent, new XWakeUpAdapter() {
+                    @Override
+                    public void onWakeUp(XAppData xAppData) {
+                        if (xAppData != null) {
+
+                            JSONObject jsonObject = xAppData.toJsonObject();
+
+                            Log.d(XinstallPlugin, jsonObject.toString());
+                            if (!registerWakeup) {
+                                Log.d(XinstallPlugin, "没有注册 wakeupCallback");
+                                wakeupAppData = xAppData;
+                                wakeupAppError = null;
+                                return;
+                            }
+
+                            PluginResult result = new PluginResult(PluginResult.Status.OK, jsonObject);
+                            result.setKeepCallback(true);
+                            wakeupCallbackContext.sendPluginResult(result);
+                        } else {
+                            if (!registerWakeup) {
+                                Log.d(XinstallPlugin, "没有注册 wakeupCallback");
+                                wakeupAppData = null;
+                                wakeupAppError = null;
+                                return;
+                            }
+                            PluginResult result = new PluginResult(PluginResult.Status.OK);
+                            result.setKeepCallback(true);
+                            wakeupCallbackContext.sendPluginResult(result);
+                        }
+                    }
+                });
+            } else if (wakeupType == 2) {
+                XInstall.getWakeUpParamEvenErrorAlsoCallBack(wakeupActivity, wakeupIntent, new XWakeUpAdapter() {
+                    @Override
+                    public void onWakeUpFinish(XAppData xAppData, XAppError xAppError) {
+                        super.onWakeUpFinish(xAppData, xAppError);
+                        JSONObject jsonObject = toJsonObjectHasError(xAppData,xAppError);
+
+                        Log.d(XinstallPlugin, jsonObject.toString());
+                        if (!registerWakeup) {
+                            Log.d(XinstallPlugin, "没有注册 wakeupDetailCallback");
+                            wakeupAppData = xAppData;
+                            wakeupAppError = xAppError;
+                            return;
+                        }
+
+                        PluginResult result = new PluginResult(PluginResult.Status.OK, jsonObject);
+                        result.setKeepCallback(true);
+                        wakeupCallbackContext.sendPluginResult(result);
+                    }
+                });
             }
-        });
+
+        }
+    }
+
+    private void getWakeUpParams(Activity activity, Intent intent) {
+        if (initialized) {
+            Log.d(XinstallPlugin,"getWakeUpParams  intent : " + intent.getDataString());
+            if (wakeupType == 1) {
+                XInstall.getWakeUpParam(activity, intent, new XWakeUpAdapter() {
+                    @Override
+                    public void onWakeUp(XAppData xAppData) {
+                        if (xAppData != null) {
+
+                            JSONObject jsonObject = xAppData.toJsonObject();
+
+                            Log.d(XinstallPlugin, jsonObject.toString());
+                            if (!registerWakeup) {
+                                Log.d(XinstallPlugin, "没有注册 wakeupCallback");
+                                wakeupAppData = xAppData;
+                                wakeupAppError = null;
+                                return;
+                            }
+
+                            PluginResult result = new PluginResult(PluginResult.Status.OK, jsonObject);
+                            result.setKeepCallback(true);
+                            wakeupCallbackContext.sendPluginResult(result);
+                        } else {
+                            if (!registerWakeup) {
+                                Log.d(XinstallPlugin, "没有注册 wakeupCallback");
+                                wakeupAppData = null;
+                                wakeupAppError = null;
+                                return;
+                            }
+                            PluginResult result = new PluginResult(PluginResult.Status.OK);
+                            result.setKeepCallback(true);
+                            wakeupCallbackContext.sendPluginResult(result);
+                        }
+                    }
+                });
+            } else {
+                XInstall.getWakeUpParamEvenErrorAlsoCallBack(activity, intent, new XWakeUpAdapter() {
+                    @Override
+                    public void onWakeUpFinish(XAppData xAppData, XAppError xAppError) {
+                        super.onWakeUpFinish(xAppData, xAppError);
+                        JSONObject jsonObject = toJsonObjectHasError(xAppData,xAppError);
+
+                        Log.d(XinstallPlugin, jsonObject.toString());
+                        if (!registerWakeup) {
+                            Log.d(XinstallPlugin, "没有注册 wakeupDetailCallback");
+                            wakeupAppData = xAppData;
+                            wakeupAppError = xAppError;
+                            return;
+                        }
+
+                        PluginResult result = new PluginResult(PluginResult.Status.OK, jsonObject);
+                        result.setKeepCallback(true);
+                        wakeupCallbackContext.sendPluginResult(result);
+                    }
+                });
+            }
+
+        } else {
+            wakeupIntent = intent;
+            wakeupActivity = activity;
+        }
+
+
     }
 
     protected void getInstallParams(CordovaArgs args, final  CallbackContext callbackContext) {
-        int timeout = -1;
+        int timeout = 0;
         if (args != null && !args.isNull(0)) {
             timeout =  args.optInt(0);
         }
@@ -122,10 +352,6 @@ public class XinstallPlugin extends CordovaPlugin {
         });
     }
 
-    protected void openYybWakeUp(final CallbackContext callbackContext) {
-        this.isOpenYyb = true;
-    }
-
     protected void reportRegister(final CallbackContext callbackContext) {
         Log.d(XinstallPlugin, "reportRegister");
         XInstall.reportRegister();
@@ -135,31 +361,116 @@ public class XinstallPlugin extends CordovaPlugin {
         if (args != null && !args.isNull(0) && !args.isNull(1)) {
             String eventId = args.optString(0);
             long eventValue = args.optLong(1);
+
+            if (eventId.length() == 0) {
+                Log.d(XinstallPlugin,"eventId 参数不得为空");
+                return;
+            }
+
+            if (eventValue == 0) {
+                Log.d(XinstallPlugin,"eventValue 参数不得为空");
+                return;
+            }
+
             Log.d(XinstallPlugin, "reportEffectEvent # eventId:" + eventId + ", eventValue:" + eventValue);
-            XInstall.reportPoint(eventId, (int) eventValue);
+            XInstall.reportEvent(eventId, (int) eventValue);
         }
     }
+	
+	protected void reportShareByXinShareId(CordovaArgs args, final CallbackContext callbackContext) {
+		if (args != null && !args.isNull(0)) {
+			String userId = args.optString(0);
+			if (userId.length() == 0) {
+			    Log.d(XinstallPlugin,"userId 参数不得为空");
+			    return;
+            }
+			Log.d(XinstallPlugin, "reportShareByXinShareId # userId:" + userId + ", userId:" + userId);
+			XInstall.reportShareByXinShareId(userId);
+		}
+	}
 
     protected void registerWakeUpHandler(CallbackContext callbackContext) {
+        if (!hasCallInit) {
+            Log.d(XinstallPlugin,"未执行SDK 初始化方法, SDK 需要手动初始化(初始方法为 init 和 initWithAd !)");
+            return;
+        }
+
+        if (wakeupType == 2) {
+            Log.d(XinstallPlugin, "registerWakeup 与 registerWakeupDetail 为互斥方法，择一选择使用");
+        }
+
+        wakeupType = 1;
+        
         //只能注册一个回调
+        registerWakeup = true;
         this.wakeupCallbackContext = callbackContext;
-        PluginResult result = new PluginResult(PluginResult.Status.NO_RESULT);
-        result.setKeepCallback(true);
-        callbackContext.sendPluginResult(result);
 
-        Intent intent = cordova.getActivity().getIntent();
-        if (intent == null)
-        {
+        if (wakeupCallbackContext != null && wakeupAppData != null) {
+            JSONObject result = wakeupAppData.toJsonObject();
+            PluginResult resultOfPlugin = new PluginResult(PluginResult.Status.OK, result);
+            resultOfPlugin.setKeepCallback(true);
+            wakeupCallbackContext.sendPluginResult(resultOfPlugin);
+            
+        } else {
+			PluginResult result = new PluginResult(PluginResult.Status.NO_RESULT);
+			result.setKeepCallback(true);
+			callbackContext.sendPluginResult(result);
+            getWakeUpParams(cordova.getActivity(),cordova.getActivity().getIntent());
+		}
+    }
+
+    protected void registerWakeUpDetailHandler(CallbackContext callbackContext) {
+        if (!hasCallInit) {
+            Log.d(XinstallPlugin,"未执行SDK 初始化方法, SDK 需要手动初始化(初始方法为 init 和 initWithAd !)");
             return;
         }
 
-        if (intent.getAction().equals(Intent.ACTION_VIEW)) {
-            if (TextUtils.isEmpty(intent.getDataString())) {
-                return;
+        if (wakeupType == 1) {
+            Log.d(XinstallPlugin, "registerWakeup 与 registerWakeupDetail 为互斥方法，择一选择使用");
+        }
+
+        wakeupType = 2;
+
+        //只能注册一个回调
+        registerWakeup = true;
+        this.wakeupCallbackContext = callbackContext;
+
+        if (wakeupCallbackContext != null && (wakeupAppData != null || wakeupAppError != null)) {
+            JSONObject result = toJsonObjectHasError(wakeupAppData,wakeupAppError);
+            PluginResult resultOfPlugin = new PluginResult(PluginResult.Status.OK, result);
+            resultOfPlugin.setKeepCallback(true);
+            wakeupCallbackContext.sendPluginResult(resultOfPlugin);
+        } else {
+            PluginResult result = new PluginResult(PluginResult.Status.NO_RESULT);
+            result.setKeepCallback(true);
+            callbackContext.sendPluginResult(result);
+            getWakeUpParams(cordova.getActivity(),cordova.getActivity().getIntent());
+        }
+    }
+
+    private JSONObject toJsonObjectHasError(XAppData xAppData, XAppError xAppError) {
+
+        JSONObject wakeUpData = new JSONObject();
+        if (xAppData != null) {
+            wakeUpData = xAppData.toJsonObject();
+        }
+        JSONObject error = new JSONObject();
+        if (xAppError != null) {
+            try {
+                error.put("errorType",xAppError.getErrorCode());
+                error.put("errorMsg",xAppError.getErrorMsg());
+            } catch (Exception e) {
+
             }
         }
-        if (wakeupCallbackContext != null) {
-            getWakeUpParams(cordova.getActivity(), this.cordova.getActivity().getIntent(), wakeupCallbackContext);
+        JSONObject result = new JSONObject();
+        try {
+            result.put("wakeUpData",wakeUpData);
+            result.put("error",error);
+        } catch (Exception e) {
+
         }
+        return  result;
     }
 }
+

package/src/ios/CDVXinstall.h

@@ -14,11 +14,19 @@ NS_ASSUME_NONNULL_BEGIN
 @property (nonatomic, strong) NSString *appKey;
 
 // 给Cordova调用的方法
+
 - (void)getInstallParams:(CDVInvokedUrlCommand *)command;
 - (void)registerWakeUpHandler:(CDVInvokedUrlCommand *)command;
 - (void)reportRegister:(CDVInvokedUrlCommand *)command;
 - (void)reportEffectEvent:(CDVInvokedUrlCommand *)command;
 
+- (void)setLog:(CDVInvokedUrlCommand *)command;
+- (void)initNoAd:(CDVInvokedUrlCommand *)command;
+- (void)initWithAd:(CDVInvokedUrlCommand *)command;
+
+- (void)registerWakeUpDetailHandler:(CDVInvokedUrlCommand *)command;
+- (void)reportShareByXinShareId:(CDVInvokedUrlCommand *)command;
+
 // AppDelegate+Xinstall 中会调用
 - (BOOL)continueUserActivity:(NSUserActivity *_Nullable)userActivity;
 

package/src/ios/CDVXinstall.m

@@ -6,16 +6,23 @@
 //
 
 #import "CDVXinstall.h"
+#if __has_include(<AdServices/AAAttribution.h>)
+    #import <AdServices/AAAttribution.h>
+#endif
 
-NSString * const XinstallThirdVersion = @"XINSTALL_THIRDSDKVERSION_1.3.3_THIRDSDKVERSION_XINSTALL";
+NSString * const XinstallThirdVersion = @"XINSTALL_THIRDSDKVERSION_1.5.5_THIRDSDKVERSION_XINSTALL";
 NSString * const XinstallThirdPlatform = @"XINSTALL_THIRDPLATFORM_CORDOVA_THIRDPLATFORM_XINSTALL";
 
 @interface CDVXinstall()
 
 @property (nonatomic, strong) NSMutableArray *marrWakeUpCallbackId;
 
+@property (nonatomic, strong) NSMutableArray *marrWakeUpDetailCallbackId;
+
 @property (nonatomic, strong) NSDictionary *dicWakeUp;
 
+@property (nonatomic, strong) NSDictionary *dicWakeUpDetail;
+
 @end
 
 @implementation CDVXinstall
@@ -69,7 +76,6 @@ NSString * const XinstallThirdPlatform = @"XINSTALL_THIRDPLATFORM_CORDOVA_THIRDP
     if (appKey){
         //暂时没有使用 传入的appKey
         self.appKey = appKey;
-        [XinstallSDK initWithDelegate:self];
         NSLog(@"%@",XinstallThirdVersion);
         NSLog(@"%@",XinstallThirdPlatform);
     }
@@ -87,6 +93,50 @@ NSString * const XinstallThirdPlatform = @"XINSTALL_THIRDPLATFORM_CORDOVA_THIRDP
     }
 }
 
+
+- (void)setLog:(CDVInvokedUrlCommand *)command {
+    if (command.arguments.count != 0) {
+        // 有参数
+        BOOL isOpen = [command.arguments objectAtIndex:0];
+        [XinstallSDK setShowLog:isOpen];
+    }
+}
+
+- (void)initNoAd:(CDVInvokedUrlCommand *)command {
+    [XinstallSDK initWithDelegate:self];
+}
+
++ (NSString *)getASAToken {
+#if __has_include(<AdServices/AAAttribution.h>)
+    if (@available(iOS 14.3, *)) {
+        NSError *error;
+        NSString *asaToken = [AAAttribution attributionTokenWithError:&error];
+        return asaToken;
+    } else {
+        return @"";
+    }
+#else
+    return @"";
+#endif
+}
+
+- (void)initWithAd:(CDVInvokedUrlCommand *)command {
+    if (command.arguments.count >= 6) {
+        // 有idfa参数
+        NSString *idfa = [command.arguments objectAtIndex:4];
+        Boolean asaEnable = [[command.arguments objectAtIndex:5] boolValue];
+        NSString *asaToken = @"";
+        if (asaEnable) {
+            asaToken = [CDVXinstall getASAToken];
+        }
+        
+        [XinstallSDK initWithDelegate:self idfa:idfa asaToken:asaToken];
+                
+        CDVPluginResult *commandResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:@{}];
+        [self.commandDelegate sendPluginResult:commandResult callbackId:command.callbackId];
+    }
+}
+
 - (void)getInstallParams:(CDVInvokedUrlCommand *)command {
     __weak __typeof(self) weakSelf = self;
     [[XinstallSDK defaultManager] getInstallParamsWithCompletion:^(XinstallData * _Nullable installData, XinstallError * _Nullable error) {
@@ -137,6 +187,7 @@ NSString * const XinstallThirdPlatform = @"XINSTALL_THIRDPLATFORM_CORDOVA_THIRDP
              
         }
         CDVPluginResult *commandResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:[installMsgDic copy]];
+        [commandResult setKeepCallbackAsBool:YES];
         [self.commandDelegate sendPluginResult:commandResult callbackId:command.callbackId];
     }];
 }
@@ -148,6 +199,7 @@ NSString * const XinstallThirdPlatform = @"XINSTALL_THIRDPLATFORM_CORDOVA_THIRDP
         // 调起已执行，并有数据
         [self.marrWakeUpCallbackId addObject:command.callbackId];
         CDVPluginResult *commandResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:[self.dicWakeUp copy]];
+        [commandResult setKeepCallbackAsBool:YES];
         [self.commandDelegate sendPluginResult:commandResult callbackId:command.callbackId];
         self.dicWakeUp = nil;
     } else {
@@ -176,6 +228,30 @@ NSString * const XinstallThirdPlatform = @"XINSTALL_THIRDPLATFORM_CORDOVA_THIRDP
     }
 }
 
+- (void)registerWakeUpDetailHandler:(CDVInvokedUrlCommand *)command {
+    if (self.dicWakeUpDetail) {
+        // 调起已执行，并有数据
+        [self.marrWakeUpDetailCallbackId addObject:command.callbackId];
+        CDVPluginResult *commandResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:[self.dicWakeUpDetail copy]];
+        [commandResult setKeepCallbackAsBool:YES];
+        [self.commandDelegate sendPluginResult:commandResult callbackId:command.callbackId];
+        self.dicWakeUpDetail = nil;
+    } else {
+        [self.marrWakeUpDetailCallbackId addObject:command.callbackId];
+    }
+    
+}
+- (void)reportShareByXinShareId:(CDVInvokedUrlCommand *)command {
+    NSString *shareId = @"";
+    if (command.arguments.count != 0) {
+        id userId = [command.arguments objectAtIndex:0];
+        if ([userId isKindOfClass:[NSString class]]) {
+            shareId = userId;
+        }
+        [[XinstallSDK defaultManager] reportShareByXinShareId:shareId];
+    }
+}
+
 #pragma mark - Tools methods
 - (NSString *)jsonStringWithObject:(id)jsonObject{
     
@@ -206,8 +282,7 @@ NSString * const XinstallThirdPlatform = @"XINSTALL_THIRDPLATFORM_CORDOVA_THIRDP
 }
 
 #pragma mark - XinstallDelegate methods
-- (void)xinstall_getWakeUpParams:(XinstallData *)appData {
-    
+- (void)xinstall_getWakeUpParams:(XinstallData *)appData error:(XinstallError *)error {
     NSDictionary *wakeMsgDic = @{};
     
     if (![CDVXinstall isEmptyData:appData]) {
@@ -253,20 +328,44 @@ NSString * const XinstallThirdPlatform = @"XINSTALL_THIRDPLATFORM_CORDOVA_THIRDP
         }
 
         wakeMsgDic = @{@"channelCode": channelCode,@"timeSpan":timeSpan, @"data": dataDic};
+        
+        if (self.marrWakeUpCallbackId.count > 0) {
+            self.dicWakeUp = nil;
+            for (int i = 0; i < self.marrWakeUpCallbackId.count; i++) {
+                NSString *callBackId = [self.marrWakeUpCallbackId objectAtIndex:i];
+                CDVPluginResult *commandResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:[wakeMsgDic copy]];
+                [commandResult setKeepCallbackAsBool:YES];
+                [self.commandDelegate sendPluginResult:commandResult callbackId:callBackId];
+            }
+        } else {
+            @synchronized (self) {
+                self.dicWakeUp = wakeMsgDic;
+            }
+        }
+    }
+    NSDictionary *mdicError = @{};
+    if (error != nil) {
+        mdicError = @{@"errorType":@(error.type),@"errorMsg":error.errorMsg};
     }
     
+    NSDictionary *dicWakeupDetail = @{@"wakeUpData":wakeMsgDic,@"error":mdicError};
     
-    if (self.marrWakeUpCallbackId.count > 0) {
-        for (int i = 0; i < self.marrWakeUpCallbackId.count; i++) {
-            NSString *callBackId = [self.marrWakeUpCallbackId objectAtIndex:i];
-            CDVPluginResult *commandResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:[wakeMsgDic copy]];
+    if (self.marrWakeUpDetailCallbackId.count > 0) {
+        self.dicWakeUpDetail = nil;
+        for (int i = 0; i < self.marrWakeUpDetailCallbackId.count ; i++) {
+            NSString *callBackId = [self.marrWakeUpDetailCallbackId objectAtIndex:i];
+            CDVPluginResult *commandResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:[dicWakeupDetail copy]];
+            [commandResult setKeepCallbackAsBool:YES];
             [self.commandDelegate sendPluginResult:commandResult callbackId:callBackId];
         }
     } else {
         @synchronized (self) {
-            self.dicWakeUp = wakeMsgDic;
+            self.dicWakeUpDetail = dicWakeupDetail;
         }
     }
+    
+    
+    
 }
 
 #pragma mark - setter and getter methods
@@ -277,9 +376,16 @@ NSString * const XinstallThirdPlatform = @"XINSTALL_THIRDPLATFORM_CORDOVA_THIRDP
     return _marrWakeUpCallbackId;
 }
 
+- (NSMutableArray *)marrWakeUpDetailCallbackId {
+    if (_marrWakeUpDetailCallbackId == nil) {
+        _marrWakeUpDetailCallbackId = [[NSMutableArray alloc] init];
+    }
+    return _marrWakeUpDetailCallbackId;
+}
+
 #pragma mark - version methods
 - (NSString *)xiSdkThirdVersion {
-    return @"1.3.0";
+    return @"1.5.5";
 }
 
 - (NSInteger)xiSdkType {

package/src/ios/libs/XinstallError.h

@@ -18,7 +18,8 @@ typedef NS_ENUM(NSInteger, XinstallErrorType) {
     XinstallErrorTypeAppForbid,                 // 该 App 已被 Xinstall 后台封禁
     XinstallErrorTypePermissionDenied,          // 该操作不被允许（一般代表调用的方法没有开通权限）
     XinstallErrorTypeParams,                    // 入参不正确
-    XinstallErrorTypeInitSDKUnfinished          // SDK 初始化未成功完成
+    XinstallErrorTypeInitSDKUnfinished,         // SDK 初始化未成功完成
+    XinstallErrorTypeNotValidWakeUp             // 没有通过 Xinstall Web SDK 集成的页面拉起
 };
 
 @interface XinstallError : NSObject

package/src/ios/libs/XinstallSDK.h

@@ -1,4 +1,4 @@
-//  1.2.9
+//  1.5.5
 //  XinstallSDK.h
 //  XinstallSDK
 //
@@ -19,9 +19,20 @@ NS_ASSUME_NONNULL_BEGIN
  * 一键拉起时获取 H5页面 携带的动态参数，参数中如果携带渠道，也会在方法中一起返回渠道号
  * @param appData 动态参数对象
  * appData 的 uo co 数据如果前端传入不是正常的json 数据，会返回前端传入的 String ，如果为正常 JSON 数据 会返回字典或数组
+ * @discuss 【注意】该方法只会在成功获取到拉起参数时，才会回调。如果无法成功获取到拉起参数，则不会执行该回调方法。
  */
 - (void)xinstall_getWakeUpParams:(nullable XinstallData *)appData;
 
+/**
+ * 一键拉起时获取 H5页面 携带的动态参数，参数中如果携带渠道，也会在方法中一起返回渠道号
+ * @param appData 动态参数对象
+ * @param error 如果没有正确处理唤醒参数，则 appData == nil 且 error != nil ；如果正确处理了唤醒参数，则 appData != nil 且 error == nil
+ * appData 的 uo co 数据如果前端传入不是正常的json 数据，会返回前端传入的 String ，如果为正常 JSON 数据 会返回字典或数组
+ * @discuss 【注意】该方法无论是否成功获取到拉起参数，均会回调。
+ * @discuss 【注意】如果同时实现了 「- xinstall_getWakeUpParams:」 和 「- xinstall_getWakeUpParams:error:」方法，那么只会回调「- xinstall_getWakeUpParams:error:」方法
+ */
+- (void)xinstall_getWakeUpParams:(nullable XinstallData *)appData error:(nullable XinstallError *)error;
+
 /**
  * 安装时获取 H5页面 携带的动态参数，参数中如果携带渠道，也会在方法中一起返回渠道号
  * @param appData 动态参数对象
@@ -51,13 +62,38 @@ NS_ASSUME_NONNULL_BEGIN
 
 /**
  * 【重要】初始化 Xinstall SDK
- * 该方法只需要调用一次，调用实际尽量提前，一般在 App 启动时调用该方法进行初始化
+ * 该方法只需要调用一次，调用时机尽量提前，一般在 App 启动时调用该方法进行初始化
  * 调用该方法前，需在 Info.plist 文件中配置键值对，键为固定值 com.xinstall.APP_KEY ，值为 Xinstall 后台对应应用的 appKey，可在 Xinstall 官方后台获取
  *
  * @param delegate 实现 XinstallDelegate 的对象
  */
 + (void)initWithDelegate:(id<XinstallDelegate> _Nonnull)delegate;
 
+/**
+ * 【重要】初始化 Xinstall SDK（支持广告平台渠道。若您不使用广告平台渠道，请使用 + initWithDelegate: 方法，否则可能导致上架 App Store 时被拒绝）
+ * 该方法只需要调用一次，调用时机尽量提前，一般在 App 启动时调用该方法进行初始化
+ * 调用该方法前，需在 Info.plist 文件中配置键值对，键为固定值 com.xinstall.APP_KEY ，值为 Xinstall 后台对应应用的 appKey，可在 Xinstall 官方后台获取
+ *
+ * @param delegate 实现 XinstallDelegate 的对象
+ * @param idfa 当前手机 IDFA 字符串
+ *
+ * @discuss [该方法和 + initWithDelegate: 的区别]：使用该方法初始化时，需要根据文档获取 IDFA 后进行初始化，支持上报广告平台渠道的数据（在 Xinstall 管理后台新建的广告平台渠道）；使用 + initWithDelegate: 方法初始化，则无法统计广告平台渠道的数据。
+ */
++ (void)initWithDelegate:(id<XinstallDelegate> _Nonnull)delegate idfa:(NSString *)idfa;
+
+/**
+ * 【重要】初始化 Xinstall SDK（支持广告平台渠道。若您不使用广告平台渠道，请使用 + initWithDelegate: 方法，否则可能导致上架 App Store 时被拒绝）
+ * 该方法只需要调用一次，调用时机尽量提前，一般在 App 启动时调用该方法进行初始化
+ * 调用该方法前，需在 Info.plist 文件中配置键值对，键为固定值 com.xinstall.APP_KEY ，值为 Xinstall 后台对应应用的 appKey，可在 Xinstall 官方后台获取
+ *
+ * @param delegate 实现 XinstallDelegate 的对象
+ * @param idfa 当前手机 IDFA 字符串，可以为空
+ * @param asaToken 当前手机 ASA token，可以为空
+ *
+ * @discuss [该方法和 + initWithDelegate: 的区别]：使用该方法初始化时，需要根据文档获取 IDFA 后进行初始化，支持上报广告平台渠道的数据（在 Xinstall 管理后台新建的广告平台渠道）；支持上报 ASA 渠道的数据
+ */
++ (void)initWithDelegate:(id<XinstallDelegate> _Nonnull)delegate idfa:(nullable NSString *)idfa asaToken:(nullable NSString *)asaToken;
+
 /**
  * 处理 通用链接
  * @param userActivity 由 AppDelegate 和 SceneDelegate 内对应方法中传入
@@ -94,6 +130,13 @@ NS_ASSUME_NONNULL_BEGIN
  */
 - (void)reportEventPoint:(NSString *_Nonnull)eventID eventValue:(long)eventValue;
 
+/**
+ * 上报一次分享id（建议在分享成功后上报）
+ *
+ * @param xinShareId 分享id
+ */
+- (void)reportShareByXinShareId:(NSString *_Nonnull)xinShareId;
+
 + (BOOL)handleSchemeURL:(NSURL *_Nullable)URL;
 
 

package/www/cordova-plugin-xinstall.js

@@ -1,6 +1,51 @@
+cordova.define("cordova-plugin-xinstall.xinstall", function(require, exports, module) {
 var exec = require('cordova/exec');
 
 module.exports = {
+	
+	/**
+	 * 不接入广告的初始化方法
+	 */
+	init: function() {
+		function pass() {};
+		exec(pass,pass,"XinstallPlugin","initNoAd",[])
+	},
+	
+	initWithAd: function (params,premissedBackBlock) {
+		function pass() {};
+		
+		var adEnable = params.adEnable;
+		if (adEnable == null) {
+			adEnable = false;
+		} 
+		
+		var oaid = params.oaid;
+	    var gaid = params.gaid;
+		var isPremission = params.isPremission;
+		
+		if (premissedBackBlock == null) {
+			premissedBackBlock = pass;
+		}
+			
+		var idfa = params.idfa;
+		if (idfa == null) {
+			idfa = "";
+		}
+		var asaEnable = params.asaEnable;
+		if (asaEnable == null) {
+            asaEnable = false;
+		}
+		
+		exec(premissedBackBlock,pass,"XinstallPlugin","initWithAd",[adEnable,oaid,gaid,isPremission,idfa,asaEnable]);
+	} ,
+	
+	
+	setLog: function (isOpen) {
+		function pass() {};
+		exec(pass,pass,"XinstallPlugin","setLog",[isOpen]);
+	},
+	
+	
     /**
      * 获取安装参数
      * @param onSuccess 成功回调：数据格式为 {'channelCode': 1002, 'data': {'key': 'value'}}
@@ -17,6 +62,13 @@ module.exports = {
         exec(onSuccess, onError, "XinstallPlugin", "registerWakeUpHandler", []);
     },
 
+    /**
+     * 注册唤醒监听（会返回相关错误）
+     */
+    registerWakeUpDetailHandler: function(onSuccess, onError){
+    	exec(onSuccess, onError, "XinstallPlugin", "registerWakeUpDetailHandler",[]);
+    },
+
     /**
      * 注册统计
      */
@@ -24,14 +76,6 @@ module.exports = {
         function pass() {};
         exec(pass, pass, "XinstallPlugin", "reportRegister", []);
     },
-	
-	/**
-	 * 开启应用宝功能
-	 */
-	openYybWakeUp: function() {
-	    function pass() {};
-	    exec(pass, pass, "XinstallPlugin", "openYybWakeUp", []);
-	}
 
     /**
      * 上报事件
@@ -41,5 +85,15 @@ module.exports = {
     reportEffectEvent: function(eventId, eventValue){
         function pass() {};
         exec(pass, pass, "XinstallPlugin", "reportEffectEvent", [eventId, eventValue]);
-    }
-};
+    },
+
+    /**
+	 * 分享裂变事件上报
+	 * @param userId 用户Id
+	 */
+	reportShareByXinShareId: function(userId) {
+	    function pass() {};
+	    exec(pass, pass, "XinstallPlugin", "reportShareByXinShareId",[userId]);
+	}
+};
+});