Skip to content

Commit 03600fb

Browse files
committed
iOS改成init手动初始化,并且整合了广告和ASA
1 parent 29584d7 commit 03600fb

File tree

9 files changed

+136
-272
lines changed

9 files changed

+136
-272
lines changed

CHANGELOG.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,13 @@
1+
## 2.3.1
2+
iOS
3+
端整合了广告平台和ASA统计相关代码,并且由用户手动初始化SDK;
4+
广告和ASA详细配置请看文档,由flutter端控制并传参数并给SDK;
5+
解决了广告平台统计时,获取隐私权限的弹窗无法弹窗的问题;
6+
集成了之前版本插件的用户,注意可能要info.plist配置隐私权限申请。
7+
18
## 2.3.0
2-
新增效果点明细API
9+
新增效果点明细API
10+
iOS端插件升级后,需要从cocoapod同步升级原生SDK到2.6.0以上
311

412
## 2.2.3
513
Android 更新 SDK 到 2.6.4

README.md

Lines changed: 22 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -248,6 +248,8 @@ Map<String, String> extraMap = {
248248
_openinstallFlutterPlugin.reportEffectPoint("effect_detail", 1, extraMap);
249249
```
250250

251+
备注:效果点明细统计需要原生iOS SDK >=2.6.0,请从CocoaPods拉取、更新、确认版本。
252+
251253
## 三、导出apk/ipa包并上传
252254

253255
集成完毕后,导出iOS/Android安装包上传[openinstall控制台](https://developer.openinstall.io/),openinstal会检查应用的集成配置
@@ -307,22 +309,33 @@ _openinstallFlutterPlugin.init(wakeupHandler);
307309
### iOS平台
308310

309311
#### 广告平台渠道和ASA渠道的配置
310-
1、工程目录下新建plugins文件夹用来存放本地插件,拷贝`openinstall_flutter_plugin`插件到plugins文件夹独自引用
311-
312-
![新建文件夹](https://res.cdn.openinstall.io/doc/flutterForder.png)
313312

314-
2、在工程中找到pubspec.yaml,修改为本地插件引用方式
313+
1、针对广告平台接入,新增配置接口,在调用`init`之前调用。
314+
``` dart
315+
var adConfig = new Map();
316+
adConfig["adEnabled"] = true;//必要,开启广告平台渠道
317+
adConfig["ASAEnable"] = true;//必要,开启苹果ASA功能
318+
//adConfig["idfaStr"] = "";//可选,通过其它插件获取的idfa字符串一般格式为xxxx-xxxx-xxxx-xxxx
319+
//adConfig["ASADebug"] = true;//可选,ASA测试debug模式,注意:正式环境中请务必关闭(不配置或配置为false)
320+
_openinstallFlutterPlugin.configIos(adConfig);
321+
```
315322

316-
![本地插件引用](https://res.cdn.openinstall.io/doc/flutterYaml.png)
323+
可选参数说明:
317324

318-
3、将 `ios/Classes/OpeninstallFlutterPlugin.m` 文件替换为 `example/ad-track/OpeninstallFlutterPlugin.m` 文件
325+
| 参数名| 参数类型 | 描述 | 要求 |
326+
| --- | --- | --- | --- |
327+
| adEnable | bool | 必要,默认为false,是否开启广告平台统计功能 ||
328+
| idfaStr | string | 可选,默认为空,用户传入的idfa字符串,用于广告平台统计功能 | adEnable为true时才生效,不配置则由插件内部去获取隐私权限和idfa字符串 |
329+
| ASAEnable | bool | 必要,默认为false,是否开启苹果ASA功能 ||
330+
| ASADebug | bool | 可选,默认为false,使用ASA功能时是否开启debug模式 | ASAEnable为true时才生效,正式环境中请务必关闭(不配置或配置为false) |
319331

320-
![文件替换](https://res.cdn.openinstall.io/doc/flutterAdTrack.png)
332+
备注:adEnable为false时,插件内部不会去请求隐私权限和idfa字符串,idfaStr配置也会失效;
333+
adEnable为true时,如果idfaStr有值且不为空,则使用idfaStr的值,如果未配置idfaStr或为空,则插件内部去获取隐私权限和idfa字符串;
321334

322-
4、需要在Info.plist文件中配置权限
335+
2、需要在 `ios/Runner/Info.plist` 文件中配置权限
323336
``` xml
324337
<key>NSUserTrackingUsageDescription</key>
325-
<string>请允许,以获取和使用您的IDFA</string>
338+
<string>为了您可以精准获取到优质推荐内容,需要您允许使用该权限</string>
326339
```
327340

328341
**备注:** 2021年iOS14.5苹果公司将正式启用idfa新隐私政策,详情可参考:[广告平台对接iOS集成指引](https://www.openinstall.io/doc/ad_ios.html)

example/ad-track/OpeninstallFlutterPlugin.m

Lines changed: 0 additions & 250 deletions
This file was deleted.

example/ios/Runner/Info.plist

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,8 @@
5555
<key>UIViewControllerBasedStatusBarAppearance</key>
5656
<false/>
5757
<key>com.openinstall.APP_KEY</key>
58-
<string>wy7kso</string>
58+
<string>appkey</string>
59+
<key>NSUserTrackingUsageDescription</key>
60+
<string>为了您可以精准获取到优质推荐内容,需要您允许使用该权限</string>
5961
</dict>
6062
</plist>

example/ios/Runner/Runner.entitlements

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<dict>
55
<key>com.apple.developer.associated-domains</key>
66
<array>
7-
<string>applinks:wy7kso.openinstall.io</string>
7+
<string>applinks:appkey.openinstall.io</string>
88
</array>
99
</dict>
1010
</plist>

example/lib/main.dart

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ class _MyAppState extends State<MyApp> {
5353
const SizedBox(height: 30),
5454
ElevatedButton(
5555
onPressed: () {
56-
_openinstallFlutterPlugin.install(installHandler);
56+
_openinstallFlutterPlugin.install(installHandler,11);
5757
},
5858
child: Text('getInstall', style: TextStyle(fontSize: 20)),
5959
),

0 commit comments

Comments
 (0)