SDK 集成

SDK 集成

此章节将演示如何集成ZJSDK到您的Flutter项目中。

提示

接入完成后,在正式上线前需要提供测试包,测试广告正常展现

Pub

项目地址

pub.dev/zjsdk_androidopen in new window

下载插件及 example

pub.dev/zjsdk_android/versionsopen in new window

测试信息

请联系运营人员获取正式的应用ID和广告位ID,测试广告位信息如下:

提示

  • SDK 不支持模拟器运行,需要使用真机调试
平台媒体IDapplicationId
安卓Z2845395984com.zj.daylottery.addemo
iOSzj_20201014iOSDEMOcom.zj.shop.towmall.hwxsx
平台类型ID平台类型ID
安卓开屏广告J2190459774iOS开屏广告J6428742394
安卓激励广告J9378481911iOS激励广告KS90010001
安卓半屏插屏J7208384505iOS半屏插屏J7311893871
安卓全屏插屏J1556676069iOS全屏插屏J7311893871
安卓信息流广告J1860767573iOS信息流广告K4000000007
安卓视频流广告J2129444408iOS视频流广告J2395763699
安卓短剧内容J2654837754iOS短剧内容J8492571135
安卓视频内容J4961952628iOS视频内容-
安卓H5页面J7513581444iOSH5页面-

注意

  • 使用测试广告位信息时需要修改工程android/app/build.gradle中的applicationIdcom.zj.daylottery.addemo。广告ID与包名是绑定关系,使用其他包名会导致广告请求失败;iOS端插件引入后,需要在原生项目Podfile引入相关预算源,麻烦您联系我们告知您。

集成 SDK

SDK 提供Flutter与原生桥接的插件,开发者可以根据需求导入或参照插件的调用方式自行开发

接入准备

注意

本插件需要Flutter >=3.0.0,请升级Flutter版本

enhanced Enum需要指定SDK>=2.17.0,请调整SDK版本

若SDK版本调整后依然报错,请手动删除.dart_tool目录重新执行pub-get

environment:
  sdk: ">=2.17.0 <4.0.0"

引入插件

推荐使用flutter pub add zjsdk_android引入插件

也可以通过修改pubspec.yamldependencies节点下添加插件并调用flutter pub get拉取

dependencies:
 zjsdk_android: '>=2.5.0 <2.6.0'

调整 AndroidManifest

如果您项目的 Android 工程中 minSdkVersion < 24,需要手动配置 android 下主模块(一般是 app)的 AndroidManifest.xml

<manifest>

    <!-- manifest节点下配置此项,如已有overrideLibrary,追加包名。例如: <uses-sdk tools:overrideLibrary="other.sdk.package.name, com.bytedance.gromore" />  -->
    <uses-sdk tools:overrideLibrary="com.bytedance.gromore" />

    <!-- application节点下增加android:label的replace配置,如已有replace,追加属性名。例如: tools:replace="android:usesCleartextTraffic,android:label" -->
    <application
      tools:replace="android:label">
    <!-- ... -->
    </application>

    <!-- ... -->

</manifest>

注意

本插件iOS端对接,需要参考原生对接文档,在原生iOS项目里面配置相关权限,请参考iOS原生对接

可参考`example/android/app/src/main/AndroidManifest.xml