@code_shuai/react-native-kuaishou-open-sdk 0.0.1 → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  从本地使用时,先在 SDK 根目录执行 `npm install && npm run build`,再在宿主安装此目录作为依赖。React Native 自动链接原生模块。应用配置完成后重新构建宿主。
8
8
 
9
- - Android 在 app 模块的现有 `manifestPlaceholders` 中加入 `KWAI_APP_ID`,值为开放平台的移动应用 App ID。与 `configure` 一致。保留 Maven Central。官方依赖提供回跳 Activity 和别名,桥接库声明主站包可见性及 FileProvider。
9
+ - Android 分享使用 `configure({ appId })` 传入的运行时 App ID,可由接口下发。宿主无需配置 `KWAI_APP_ID`;桥接库在 Manifest 中为空缺的官方 AAR App ID 元数据提供空字符串默认值,每次分享前调用官方 `updateKwaiAppId(appId)`。已有宿主可继续显式声明 Manifest App ID,分享以运行时值为准;仅配置 Gradle 占位符时可删除该配置。保留 Maven Central。官方依赖提供按宿主包名注册的回跳 Activity 和别名,桥接库声明主站包可见性及 FileProvider。本库未封装快手账号授权登录,该能力需由宿主显式覆盖上述授权元数据,并按官方授权文档接入。
10
10
  - iOS 执行 `pod install`。将 App ID 加到 URL Types,并按官方文档合并 `LSApplicationQueriesSchemes`、Associated Domains 和 AASA。将快手登记的 HTTPS Universal Link(结尾为 `/`)传给 `configure`。在宿主的 AppDelegate 或 SceneDelegate 中将匹配快手回跳的 URL 和 Universal Link 交给 `[RNKuaishouOpenSDK handleOpenURL:url]`、`[RNKuaishouOpenSDK handleOpenUniversalLink:userActivity]`。其他链接继续走宿主现有处理链。使用相册素材前,由宿主声明 `NSPhotoLibraryUsageDescription` 并取得所需访问权限。
11
11
  - iOS 官方 Pod 使用静态库。用 arm64 真机联调,模拟器不能验证快手分享。3.7.3 头文件标注视频编辑需要申请权限。
12
12
  - 测试和发布构建均使用实际登记的应用标识。应用凭据中的 App Secret 不需要传给客户端。
@@ -41,6 +41,8 @@ const result = await Kuaishou.share({
41
41
  | `share()` | 保留输入顺序。Android 使用 `SinglePictureEdit`、`MultiPictureEdit`、`SingleVideoEdit`。iOS 使用 `KSShareMediaRequest` 及图片/视频编辑类型。图片至少一张,视频仅一条。多图上限和媒体兼容性待真机确认。Android 发送时准备缓存和临时只读授权,过期文件在后续请求时清理。 |
42
42
  | `cancelPendingShare()` | 停止本地等待。返回是否存在待处理请求。 |
43
43
 
44
+ 同一配置可重复初始化,Android 在没有待处理分享时可以更换 App ID,等待分享期间更换会返回 `E_BUSY`。接口下发的 App ID 仍需在开放平台登记当前包名、签名及分享权限。
45
+
44
46
  一次只允许一个请求,默认等待 120 秒,可通过 `timeoutMs` 调整。收到已关联的 SDK 响应后返回 `status`、`platform`、`nativeResponse`。SDK 报告成功不表示作品已发布。SDK 没有明确的媒体取消信号时,不将拒绝或未回跳映射为用户取消。参数无效、未安装、能力不支持、权限不足、拉起失败、并发和超时等本地错误通过 Promise 拒绝返回,按错误的 `code` 处理。进程被杀后无法恢复旧请求。
45
47
 
46
48
  调用示例见 [shareMedia.ts](example/shareMedia.ts)。原生配置见 [快手 Android 文档](https://open.kuaishou.com/platformDocs/develop/mobile-app/android.html)与 [快手 iOS 文档](https://open.kuaishou.com/platformDocs/develop/mobile-app/ios.html)。
@@ -1,8 +1,19 @@
1
- <manifest xmlns:android="http://schemas.android.com/apk/res/android">
1
+ <manifest
2
+ xmlns:android="http://schemas.android.com/apk/res/android"
3
+ xmlns:tools="http://schemas.android.com/tools">
2
4
  <queries>
3
5
  <package android:name="com.smile.gifmaker" />
4
6
  </queries>
5
7
  <application>
8
+ <!-- Sharing receives its App ID at runtime. Override the official AAR placeholders. -->
9
+ <meta-data
10
+ android:name="APP_ID"
11
+ android:value=""
12
+ tools:replace="android:value" />
13
+ <meta-data
14
+ android:name="KWAI_APP_ID"
15
+ android:value=""
16
+ tools:replace="android:value" />
6
17
  <provider
7
18
  android:name=".KuaishouFileProvider"
8
19
  android:authorities="${applicationId}.rn-kuaishou.files"
@@ -79,23 +79,19 @@ public final class KuaishouModule extends ReactContextBaseJavaModule {
79
79
  main.post(() -> {
80
80
  try {
81
81
  String id = config.getString("appId");
82
- if (pending != null && !id.equals(appId)) {
83
- promise.reject("E_BUSY", "A share is pending");
82
+ if (id == null || id.trim().isEmpty()) {
83
+ promise.reject("E_INVALID_CONFIG", "A Kuaishou App ID is required");
84
84
  return;
85
85
  }
86
- var info = context.getPackageManager().getApplicationInfo(
87
- context.getPackageName(), PackageManager.GET_META_DATA
88
- );
89
- String manifestId = info.metaData == null ? null : info.metaData.getString("APP_ID");
90
- if (id == null || !id.equals(manifestId)) {
91
- promise.reject("E_INVALID_CONFIG", "App ID must match Android KWAI_APP_ID");
86
+ if (pending != null && !id.equals(appId)) {
87
+ promise.reject("E_BUSY", "A share is pending");
92
88
  return;
93
89
  }
94
90
  appId = id;
95
91
  promise.resolve(null);
96
92
  }
97
93
  catch (Exception error) {
98
- promise.reject("E_INVALID_CONFIG", "Could not read Android App ID");
94
+ promise.reject("E_INVALID_CONFIG", "A valid Kuaishou App ID is required");
99
95
  }
100
96
  });
101
97
  }
@@ -269,6 +265,7 @@ public final class KuaishouModule extends ReactContextBaseJavaModule {
269
265
  try {
270
266
  KwaiOpenAPI api = new KwaiOpenAPI(context);
271
267
  work.api = api;
268
+ // The sharing API uses this runtime ID instead of the Manifest fallback.
272
269
  api.updateKwaiAppId(appId);
273
270
  api.setOpenSdkConfig(new OpenSdkConfig.Builder()
274
271
  .setGoToMargetAppNotInstall(false)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@code_shuai/react-native-kuaishou-open-sdk",
3
- "version": "0.0.1",
3
+ "version": "0.0.2",
4
4
  "description": "React Native bridge for Kuaishou Open SDK media sharing",
5
5
  "main": "lib/index.js",
6
6
  "types": "lib/index.d.ts",