抖音开放平台Logo
开发者文档
移动/网站应用
控制台
  • 移动应用
  • 网站应用

    • Android 接入
    收藏
    我的收藏

    本文为抖音短视频 Android 终端 SDK 新手使用教程，只涉及 SDK 的使用方法，默认读者已经具有使用 Android Studio 开发 Android 程序的经验，以及相关的编程知识基础等。​

    ​前提条件​

      •​请确保 SDK 最低支持 Android API 15 - 4.0.x 版本。​
      •​向抖音短视频申请你的 ClientKey（下文简称 AppID）及相关权限：​
      a.​请到开发者应用登记页面进行申请，申请后将获得 AppID。具体步骤请参见创建移动应用和网站应用。​
      b.​通过 AppID 为应用申请相关的权限，如分享、授权等。​
      c.​审核通过后即可使用相关的功能。​

    ​接入流程​

    SDK 接入目前需要引入两个依赖包，包括opensdk-china-external和opensdk-common，为了方便，两者使用同样的版本号。当前最新版本为 0.2.0.2。​
      1.​将 SDK 集成到开发环境。​
      2.​配置抖音的软件包可见性。​

    ​操作步骤​

      1.​将 SDK 集成到开发环境，需要添加如下配置。​
    //gradle文件中添加：
repositories {
    maven { url 'https://artifact.bytedance.com/repository/AwemeOpenSDK' }
}

dependencies {
    implementation 'com.bytedance.ies.ugc.aweme:opensdk-china-external:0.2.0.2'
    implementation 'com.bytedance.ies.ugc.aweme:opensdk-common:0.2.0.2'
}
      2.​配置抖音的软件包可见性。​
    Android 11 为了加强了隐私保护策略，引入了很多变更和限制，其中软件包可见性变更，将会导致第三方应用通过抖音开放平台的 SDK 无法正常拉起抖音，从而无法使用开放平台的全部功能，包括但不限于分享消息到抖音、通过抖音进行账号登录等功能。特别需要注意的是，Android11 的该变更只会影响到升级<strong>targetSdkVersion=30</strong>的应用，未升级的应用暂不受影响。​
    <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.xxx.xxxx">
  <queries>
    <!--允许查询抖音和抖音极速版的软件包信息-->
    <package android:name="com.ss.android.ugc.aweme" />
    <package android:name="com.ss.android.ugc.aweme.lite" />
    <package android:name="com.ss.android.ugc.live" />
  </queries>
</manifest>
    至此，SDK 开发环境配置完毕. 具体子功能接入请查阅相关功能接入文档。​
    常见问题，请参见 Android 常见问题。​