市场平台
作者 NativeScript.org
@makewaves/tiktok-sdk
由 makewaves 提供 | v1.0.10
添加插件描述
npm i --save @makewaves/tiktok-sdk

@makewaves/tiktok-sdk

一个 NativeScript 插件，允许您使用 TikTok Open SDK 进行用户认证，包括 LoginKit。

安装

添加插件

使用以下命令将插件添加到您的项目中

npm install @makewaves/tiktok-sdk

设置 Swift 包管理器

将 Swift 包管理器块添加到项目中的 nativescript.config.ts 文件。

ios: {
    SPMPackages: [
      {
        name: "TikTokOpenSDK",
        libs: ["TikTokOpenAuthSDK", "TikTokOpenSDKCore", "TikTokOpenShareSDK"],
        repositoryURL: "https://github.com/tiktok/tiktok-opensdk-ios.git",
        version: "2.2.0"
      }
    ]
  }

在应用程序启动时运行初始化

为了在 iOS 上连接 AppDelegate 函数，初始化需要在应用程序启动时运行。

为此，将以下行添加到您的 app.ts/app.js 入口文件

TikTok.setup(Application);

例如

import { Application } from '@nativescript/core';
import { TikTok } from '@makewaves/tiktok-sdk';

TikTok.setup(Application);

Application.run({ moduleName: 'app-root' });

有关此步骤的更多信息，请参阅 TikTok 移动 SDK 快速入门指南。

配置

  1. 访问 TikTok 开发者门户 并在 TikTok for Developers 网站上注册开发者账户。

  2. 创建一个新的应用程序，添加所需详细信息，并提交进行审查。这将为您提供客户端密钥和客户端密钥，该密钥对于您的应用程序是唯一的，将在下一步中使用。

配置 iOS

为了在 iOS 设备上运行 TikTok 移动 SDK，您需要一个有效的通用链接配置和一个具有关联域功能的配置文件。导入您的配置文件，更新捆绑 ID，并将您的通用链接域添加到关联域部分。确保您已将您的通用链接添加到开发者门户中 Login Kit 部分的重定向 URI 部分。

有关 NativeScript 中通用链接的更多信息，请参阅 此处。

一旦您已配置了 iOS 的通用链接，请将以下块添加到您的 App_Resources/iOS/Info.plist 文件，并根据您的需求修改以下键值对

  • 将以下值添加到 LSApplicationQueriesSchemes

    • 用于 Login Kit 的 tiktokopensdk。
    • 用于 Share Kit 的 tiktoksharesdk。
    • 用于检查设备上是否安装了 TikTok 的 snssdk1233 和 snssdk1180。

  • 使用从 TikTok for Developers 网站获得的客户端密钥作为值添加 TikTokClientKey 键。将您的应用程序客户端密钥添加到 CFBundleURLSchemes。

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>tiktokopensdk</string>
  <string>tiktoksharesdk</string>
  <string>snssdk1180</string>
  <string>snssdk1233</string>
</array>

<key>TikTokClientKey</key>
<string>$TikTokClientKey</string>

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>$TikTokClientKey</string>
    </array>
  </dict>
</array>

请记住将 $TikTokClientKey 替换为您的实际密钥。

配置 Android

在 TikTok for Developers 网站上注册您的应用程序。您必须在应用程序注册过程中提供您的 MD5 和 SHA256 证书指纹。

如果您的应用程序使用 Google Play 进行应用程序签名，请从 Play 控制台中应用程序签名页面复制 MD5 和 SHA-256 指纹。

如果您的应用程序正在使用自签名，您可以根据以下说明使用 Keytool 获取 MD5 和 SHA-256。

使用 Keytool，打开终端并运行 keytool 工具以获取证书的 MD5 和 SHA-256 指纹。

keytool -list -v \
-alias <your-key-name> -keystore <path-to-production-keystore>

MD5: 75:C8:69:FC:D5:6E:EB:1D:02:79:A9:3F:91:BD:5E:5B
SHA1: EE:26:47:EC:59:83:6A:91:3C:7A:E1:61:14:56:6D:D8:90:B7:BA:3E
SHA-256: 6C:CF:15:C0:17:2E:EF:3E:48:2F:7E:E8:ED:6D:06:CB:CB:52:A4:CF:AD:CE:42:0B:80:9D:D5:D9:DE:DA:4C:7D

在 TikTok for Developers 网站上提供您的应用程序的 MD5 和 SHA-256。

  • 在应用程序签名字段中，从 MD5 字符串中删除冒号并提供 32 位签名。
  • 在签名证书指纹字段中，直接提供您的 SHA-256 字符串。

由于 Android 11 关于包可见性的变化，您还需要将以下内容添加到项目的 Android Manifest 文件中。

<queries>
    <package android:name="com.zhiliaoapp.musically" />
    <package android:name="com.ss.android.ugc.trill" />
</queries>

用法

// TODO

许可协议

Apache许可证版本2.0