@cloudcare/cocos-sdk 0.1.0-alpha.5 → 0.1.0-alpha.6

package/dist/creator3/creator3/index.js

@@ -2,22 +2,11 @@ import { FTDefaultAutoTracking } from '../core/auto-tracking.js';
 import { FTCocosSDK } from '../core/client.js';
 import { FTLogger, FTRUM, FTTrace } from '../core/modules.js';
 import { FTCreator3TrackingHooks } from './auto.js';
-import { FTCreator3CanvasCapture } from './capture.js';
 import { FTCreator3Transport } from './transport.js';
 const transport = new FTCreator3Transport();
-const capture = new FTCreator3CanvasCapture();
 const hooks = new FTCreator3TrackingHooks();
 const autoTracking = new FTDefaultAutoTracking(new FTRUM(transport), new FTLogger(transport), new FTTrace(transport), hooks);
 /** Shared SDK entry point for Cocos Creator 3.x applications. */
-export const guanceSdk = new FTCocosSDK(transport, capture, autoTracking, hooks);
-/**
- * Selects the Cocos Creator 3 camera used to capture Session Replay frames.
- * Call this after the camera is available and before starting Replay.
- *
- * @param camera - Active Cocos `Camera` component.
- */
-export function setReplayCamera(camera) {
-    capture.setCamera(camera);
-}
+export const guanceSdk = new FTCocosSDK(transport, autoTracking, 'creator3');
 export * from '../core/index.js';
 //# sourceMappingURL=index.js.map

package/dist/creator3/creator3/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/creator3/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,SAAS,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAC5C,MAAM,OAAO,GAAG,IAAI,uBAAuB,EAAE,CAAC;AAC9C,MAAM,KAAK,GAAG,IAAI,uBAAuB,EAAE,CAAC;AAC5C,MAAM,YAAY,GAAG,IAAI,qBAAqB,CAC5C,IAAI,KAAK,CAAC,SAAS,CAAC,EACpB,IAAI,QAAQ,CAAC,SAAS,CAAC,EACvB,IAAI,OAAO,CAAC,SAAS,CAAC,EACtB,KAAK,CACN,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;AAEjF;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAe;IAC7C,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/creator3/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,SAAS,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAC5C,MAAM,KAAK,GAAG,IAAI,uBAAuB,EAAE,CAAC;AAC5C,MAAM,YAAY,GAAG,IAAI,qBAAqB,CAC5C,IAAI,KAAK,CAAC,SAAS,CAAC,EACpB,IAAI,QAAQ,CAAC,SAAS,CAAC,EACvB,IAAI,OAAO,CAAC,SAAS,CAAC,EACtB,KAAK,CACN,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,UAAU,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;AAE7E,cAAc,kBAAkB,CAAC"}

package/dist/creator3/creator3/transport.d.ts

@@ -2,7 +2,6 @@ import { type FTNativeTransport } from '../core/transport.js';
 import type { FTValue } from '../core/types.js';
 export declare class FTCreator3Transport implements FTNativeTransport {
     readonly platform: 'android' | 'ios' | 'unsupported';
-    invokeAsync<T = FTValue>(method: string, payload?: unknown): Promise<T | undefined>;
     constructor();
     invoke<T = FTValue>(method: string, payload?: unknown): T | undefined;
 }

package/dist/creator3/creator3/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../../src/creator3/transport.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGhD,qBAAa,mBAAoB,YAAW,iBAAiB;IAC3D,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,KAAK,GAAG,aAAa,CAAC;IAErD,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;;IAcnF,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS;CActE"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../../src/creator3/transport.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,qBAAa,mBAAoB,YAAW,iBAAiB;IAC3D,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,KAAK,GAAG,aAAa,CAAC;;IAYrD,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS;CActE"}

package/dist/creator3/creator3/transport.js

@@ -1,11 +1,7 @@
 import { native, sys } from 'cc';
 import { NATIVE } from 'cc/env';
 import { parseTransportResponse } from '../core/transport.js';
-import { invokeReplayAsync } from '../core/replay-async-transport.js';
 export class FTCreator3Transport {
-    invokeAsync(method, payload) {
-        return invokeReplayAsync(this, method, payload);
-    }
     constructor() {
         this.platform = !NATIVE
             ? 'unsupported'

package/dist/creator3/creator3/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../../../src/creator3/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAA0B,MAAM,sBAAsB,CAAC;AAEtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,MAAM,OAAO,mBAAmB;IAG9B,WAAW,CAAc,MAAc,EAAE,OAAiB;QACxD,OAAO,iBAAiB,CAAI,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED;QACE,IAAI,CAAC,QAAQ,GAAG,CAAC,MAAM;YACrB,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,OAAO;gBACzB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG;oBACrB,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,aAAa,CAAC;IACxB,CAAC;IAED,MAAM,CAAc,MAAc,EAAE,OAAiB;QACnD,IAAI,IAAI,CAAC,QAAQ,KAAK,aAAa;YAAE,OAAO,SAAS,CAAC;QACtD,MAAM,IAAI,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACpE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,KAAK,SAAS;YACrC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAChC,gCAAgC,EAChC,QAAQ,EACR,0DAA0D,EAC1D,MAAM,EACN,IAAI,CACL;YACH,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,eAAe,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACzF,OAAO,sBAAsB,CAAI,GAAG,CAAC,CAAC;IACxC,CAAC;CACF"}
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../../../src/creator3/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAA0B,MAAM,sBAAsB,CAAC;AAGtF,MAAM,OAAO,mBAAmB;IAG9B;QACE,IAAI,CAAC,QAAQ,GAAG,CAAC,MAAM;YACrB,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,OAAO;gBACzB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG;oBACrB,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,aAAa,CAAC;IACxB,CAAC;IAED,MAAM,CAAc,MAAc,EAAE,OAAiB;QACnD,IAAI,IAAI,CAAC,QAAQ,KAAK,aAAa;YAAE,OAAO,SAAS,CAAC;QACtD,MAAM,IAAI,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACpE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,KAAK,SAAS;YACrC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAChC,gCAAgC,EAChC,QAAQ,EACR,0DAA0D,EAC1D,MAAM,EACN,IAAI,CACL;YACH,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,eAAe,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACzF,OAAO,sBAAsB,CAAI,GAAG,CAAC,CAAC;IACxC,CAAC;CACF"}

package/extensions/creator2/install-native.cjs

@@ -3,6 +3,7 @@
 const fs = require('fs');
 const path = require('path');
 const { execFileSync } = require('child_process');
+const { syncManagedDirectory } = require('./managed-assets.cjs');
 
 const BEGIN = '/* COCOS_SDK_BEGIN */';
 const END = '/* COCOS_SDK_END */';
@@ -28,14 +29,32 @@ function installNative(buildRoot, extensionRoot, logger = console) {
     logger.warn(`[cocos-sdk] Native bridge not found at ${nativeSource}`);
     return;
   }
+  const replayDescriptor = path.join(extensionRoot, 'replay-integration.json');
+  const replay = fs.existsSync(replayDescriptor) ? JSON.parse(fs.readFileSync(replayDescriptor, 'utf8')) : null;
+  const installedFile = path.join(extensionRoot, 'sdk-integration.json');
+  const installed = fs.existsSync(installedFile) ? JSON.parse(fs.readFileSync(installedFile, 'utf8')) : null;
+  if (installed?.replay && !replay) throw new Error('[cocos-sdk] Replay assets are missing. Run guance-cocos install --replay.');
+  if (replay && (replay.schemaVersion !== 1 || !installed || replay.baseVersion !== installed.version || replay.version !== installed.version || replay.iosSdkVersion !== '1.6.8-alpha.5')) {
+    throw new Error('[cocos-sdk] Replay native integration version does not match the base SDK. Reinstall matching packages.');
+  }
+  const replaySource = path.join(extensionRoot, 'replay-native');
   const buildNative = path.join(buildRoot, 'cocos-sdk-native');
-  copyDirectory(nativeSource, buildNative);
-  const files = findFiles(buildRoot, 7);
-  const replayHeader = path.join(buildNative, 'shared', 'FTReplayFileBridge.h');
-  if (fs.existsSync(replayHeader)) {
-    findReplayEntryFiles(files)
-      .forEach((file) => patchReplayFileBridge(file, replayHeader));
+  const sources = [{ root: nativeSource }];
+  if (replay) sources.push({ root: replaySource, prefix: 'replay/' });
+  if (dependencyManager === 'spm') {
+    sources.push({ root: path.join(nativeSource, 'ios'), prefix: 'FTCocosBridge/' });
+    if (replay) sources.push({ root: path.join(replaySource, 'ios'), prefix: 'FTCocosReplayBridge/' });
   }
+  const modules = 'android/src/main/java/com/ft/sdk/cocos/FTCocosBridgeModules.java';
+  const dispatcher = fs.readFileSync(path.join(nativeSource, modules), 'utf8');
+  const configuredDispatcher = replay ? dispatcher.replace(
+    '        return "{',
+    '        if ("session-replay".equals(endpoint)) return FTCocosReplayBridge.invokeLocal(method, payload);\n        return "{',
+  ) : dispatcher;
+  syncManagedDirectory(buildNative, sources, { [modules]: configuredDispatcher });
+  const files = findFiles(buildRoot, 7);
+  const replayHeader = replay ? path.join(buildNative, 'replay', 'shared', 'FTReplayFileBridge.h') : null;
+  findReplayEntryFiles(files).forEach(file => patchReplayFileBridge(file, replayHeader));
   const gradlePropertiesFiles = files.filter((file) => path.basename(file) === 'gradle.properties');
   const gradleFiles = uniqueFiles([
     ...files.filter((file) => /(?:^|\/)app\/build\.gradle$/.test(normalize(file))),
@@ -50,7 +69,6 @@ function installNative(buildRoot, extensionRoot, logger = console) {
     .filter((project) => project.target);
   if (dependencyManager === 'spm' && iosApplicationProjects.length > 0) {
     migrateManagedPods(podfiles, logger);
-    copyDirectory(path.join(nativeSource, 'ios'), path.join(buildNative, 'FTCocosBridge'));
   }
   if (dependencyManager === 'cocoapods' && podfiles.length === 0) {
     iosApplicationProjects.forEach(({ projectFile, target }) => {
@@ -63,14 +81,18 @@ function installNative(buildRoot, extensionRoot, logger = console) {
   iosApplicationProjects.forEach(({ projectFile, target }) => {
     patchCocos2IosConfiguration(projectFile, target);
     if (dependencyManager === 'spm') {
-      require('./install-spm.cjs').installSwiftPackage(projectFile, path.join(buildNative, 'FTCocosBridge'), 'FTCocosBridge', target);
-    } else if (fs.readFileSync(projectFile, 'utf8').includes('XCLocalSwiftPackageReference')) {
+      const spm = require('./install-spm.cjs');
+      if (!replay) spm.removeSwiftPackages(projectFile, ['FTCocosReplayBridge']);
+      spm.installSwiftPackage(projectFile, path.join(buildNative, 'FTCocosBridge'), 'FTCocosBridge', target);
+      if (replay) spm.installSwiftPackage(projectFile, path.join(buildNative, 'FTCocosReplayBridge'), 'FTCocosReplayBridge', target);
+    } else if (fs.readFileSync(projectFile, 'utf8').includes('XCLocalSwiftPackageReference')
+      || fs.existsSync(path.join(path.dirname(projectFile), 'cocos-sdk-spm.json'))) {
       require('./install-spm.cjs').removeSwiftPackages(projectFile);
     }
   });
-  gradleFiles.forEach((file) => patchGradle(file, buildNative));
+  gradleFiles.forEach((file) => patchGradle(file, buildNative, replay));
   gradlePropertiesFiles.forEach(patchGradleProperties);
-  if (dependencyManager === 'cocoapods') podfiles.forEach((file) => patchPodfile(file, buildNative));
+  if (dependencyManager === 'cocoapods') podfiles.forEach((file) => patchPodfile(file, buildNative, replay));
   logger.info(
     `[cocos-sdk] Installed native bridge (${gradleFiles.length} Android, ${dependencyManager === 'spm' ? iosApplicationProjects.length : podfiles.length} iOS project files; iOS: ${dependencyManager}).`,
   );
@@ -85,6 +107,12 @@ function patchReplayFileBridge(file, header) {
   // Creator 3 shares Game.cpp across iOS/Android builds. Keep its include stable
   // when another platform's build directory is cleaned or regenerated.
   const sharedDirectory = path.join(path.dirname(file), 'cocos-sdk-replay');
+  if (!header) {
+    const next = original.replace(markedPattern(includeBegin, includeEnd), '').replace(markedPattern(initBegin, initEnd), '');
+    if (fs.existsSync(sharedDirectory)) syncManagedDirectory(sharedDirectory, []);
+    if (next !== original) fs.writeFileSync(file, next);
+    return;
+  }
   const include = `${includeBegin}\n#include "cocos-sdk-replay/FTReplayFileBridge.h"\n${includeEnd}`;
   const init = `${initBegin}\n    ft_cocos::installReplayFileBridge();\n    ${initEnd}\n    `;
   let next = original;
@@ -100,7 +128,7 @@ function patchReplayFileBridge(file, header) {
   next = markedPattern(includeBegin, includeEnd).test(next)
     ? next.replace(markedPattern(includeBegin, includeEnd), include)
     : `${include}\n${next}`;
-  copyDirectory(path.dirname(header), sharedDirectory);
+  syncManagedDirectory(sharedDirectory, [{ root: path.dirname(header) }]);
   if (next !== original) fs.writeFileSync(file, next);
 }
 
@@ -251,12 +279,14 @@ function compareVersions(left, right) {
   return 0;
 }
 
-function patchGradle(file, nativeRoot) {
+function patchGradle(file, nativeRoot, replay) {
   const javaDir = normalize(path.join(nativeRoot, 'android', 'src', 'main', 'java'));
+  const javaDirs = [javaDir];
+  if (replay) javaDirs.push(normalize(path.join(nativeRoot, 'replay', 'android', 'src', 'main', 'java')));
   replaceMarkedBlock(file, [
     BEGIN,
     'android {',
-    `    sourceSets { main.java.srcDirs += ['${escapeGroovy(javaDir)}'] }`,
+    `    sourceSets { main.java.srcDirs += [${javaDirs.map(dir => `'${escapeGroovy(dir)}'`).join(', ')}] }`,
     '}',
     'repositories {',
     "    maven { url 'https://mvnrepo.guance.com/repository/maven-releases' }",
@@ -264,21 +294,22 @@ function patchGradle(file, nativeRoot) {
     'dependencies {',
     "    implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-sdk:1.7.6-alpha03'",
     "    implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-native:1.1.3'",
-    "    implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-session-replay:0.1.9-alpha03'",
+    ...(replay ? [`    implementation '${escapeGroovy(replay.androidReplay)}'`] : []),
     "    implementation 'com.google.code.gson:gson:2.10.1'",
     "    implementation platform('org.jetbrains.kotlin:kotlin-bom:1.8.22')",
     "    implementation 'androidx.appcompat:appcompat:1.1.0'",
-    "    implementation 'androidx.fragment:fragment:1.8.0'",
+    ...(replay ? [`    implementation '${escapeGroovy(replay.androidFragment)}'`] : []),
     '}',
     END,
   ].join('\n'), BEGIN, END, [[LEGACY_BEGIN, LEGACY_END]]);
 }
 
-function patchPodfile(file, nativeRoot) {
+function patchPodfile(file, nativeRoot, replay) {
   const iosDir = normalize(path.join(nativeRoot, 'ios'));
   const block = [
     POD_BEGIN,
     `pod 'FTCocosBridge', :path => '${escapeRuby(iosDir)}'`,
+    ...(replay ? [`pod 'FTCocosReplayBridge', :path => '${escapeRuby(normalize(path.join(nativeRoot, 'replay', 'ios')))}'`] : []),
     POD_END,
   ].join('\n');
   const original = fs.readFileSync(file, 'utf8');
@@ -308,7 +339,8 @@ function replaceIndentedMarkedBlock(contents, begin, end, block) {
 
 function findIosApplicationTarget(projectFile) {
   const contents = fs.readFileSync(projectFile, 'utf8');
-  if (contents.includes('COCOS_SDK_XCODE_PROJECT')) {
+  if (contents.includes('COCOS_SDK_XCODE_PROJECT')
+    || fs.existsSync(path.join(path.dirname(projectFile), 'cocos-sdk-spm.json'))) {
     const { readProject, applicationTarget } = require('./install-spm.cjs');
     return applicationTarget(readProject(projectFile))?.[1].name || null;
   }
@@ -366,16 +398,6 @@ function markedPattern(begin, end) {
   return new RegExp(`${escapeRegExp(begin)}[\\s\\S]*?${escapeRegExp(end)}`, 'm');
 }
 
-function copyDirectory(source, destination) {
-  fs.mkdirSync(destination, { recursive: true });
-  for (const entry of fs.readdirSync(source, { withFileTypes: true })) {
-    const from = path.join(source, entry.name);
-    const to = path.join(destination, entry.name);
-    if (entry.isDirectory()) copyDirectory(from, to);
-    else fs.copyFileSync(from, to);
-  }
-}
-
 function findFiles(root, maxDepth) {
   const result = [];
   function visit(directory, depth) {
@@ -425,14 +447,14 @@ function migrateManagedPods(podfiles, logger) {
       [POD_BEGIN, POD_END], [LEGACY_POD_BEGIN, LEGACY_POD_END], [LEGACY_BEGIN, LEGACY_END],
       ['# COCOS_HYBRID_SAMPLE_BEGIN', '# COCOS_HYBRID_SAMPLE_END'],
     ]) next = next.replace(markedPattern(begin, end), '');
-    if (/^\s*pod\s+['"](?:FTCocosBridge|HybridSampleHost|GuanceSDK)(?:\/[^'"]*)?['"]/m.test(next)) {
+    if (/^\s*pod\s+['"](?:FTCocosBridge|FTCocosReplayBridge|HybridSampleHost|GuanceSDK)(?:\/[^'"]*)?['"]/m.test(next)) {
       throw new Error(`[cocos-sdk] Remove the manually declared native SDK Pod from ${file} before switching to SPM.`);
     }
     if (next !== original) fs.writeFileSync(file, next);
     const directory = path.dirname(file);
     const existingLock = path.join(directory, 'Podfile.lock');
     const hasSDKPods = fs.existsSync(existingLock)
-      && /^\s*- (?:FTCocosBridge|HybridSampleHost|GuanceSDK)(?:\/|\s|:)/m.test(fs.readFileSync(existingLock, 'utf8'));
+      && /^\s*- (?:FTCocosBridge|FTCocosReplayBridge|HybridSampleHost|GuanceSDK)(?:\/|\s|:)/m.test(fs.readFileSync(existingLock, 'utf8'));
     if (next === original && !hasSDKPods) continue;
     if (fs.existsSync(path.join(directory, 'Podfile.lock')) || fs.existsSync(path.join(directory, 'Pods'))) {
       logger.info('[cocos-sdk] Updating existing Pods integration for the SPM switch.');

package/extensions/creator2/install-spm.cjs

@@ -145,11 +145,11 @@ function preserveCmakeIntegration(projectFile, project, entry) {
   if (!fs.existsSync(stateFile) || fs.readFileSync(stateFile, 'utf8') !== serialized) fs.writeFileSync(stateFile, serialized);
 }
 
-function removeSwiftPackages(projectFile) {
+function removeSwiftPackages(projectFile, productNames = ['FTCocosBridge', 'FTCocosReplayBridge', 'HybridSampleHost']) {
   const project = readProject(projectFile);
   const objects = project.objects;
   const removed = new Set();
-  for (const productName of ['FTCocosBridge', 'HybridSampleHost']) {
+  for (const productName of productNames) {
     const packageID = identifier(`package:${productName}`);
     if (!objects[packageID]) continue;
     removed.add(packageID);
@@ -159,23 +159,31 @@ function removeSwiftPackages(projectFile) {
       removed.add(identifier(`framework:${id}:${productName}`));
     }
   }
-  if (!removed.size) return;
   for (const id of removed) delete objects[id];
   for (const object of Object.values(objects)) {
     for (const key of ['packageReferences', 'packageProductDependencies', 'files']) {
       if (Array.isArray(object[key])) object[key] = object[key].filter((id) => !removed.has(id));
     }
-    if (object.isa === 'PBXShellScriptBuildPhase') object.shellScript = (object.shellScript || '').replace(restorePattern, '');
+
   }
   const stateFile = path.join(path.dirname(projectFile), 'cocos-sdk-spm.json');
   if (fs.existsSync(stateFile)) {
     const state = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
-    for (const [id, settings] of Object.entries(state.buildLocations)) {
-      if (objects[id]) Object.assign(objects[id].buildSettings ||= {}, settings);
+    state.packages = state.packages.filter(item => !productNames.includes(item.productName));
+    if (state.packages.length) {
+      fs.writeFileSync(stateFile, `${JSON.stringify(state, null, 2)}\n`);
+    } else {
+      for (const [id, settings] of Object.entries(state.buildLocations)) {
+        if (objects[id]) Object.assign(objects[id].buildSettings ||= {}, settings);
+      }
+      for (const object of Object.values(objects)) {
+        if (object.isa === 'PBXShellScriptBuildPhase') object.shellScript = (object.shellScript || '').replace(restorePattern, '');
+      }
+      fs.unlinkSync(stateFile);
+      fs.rmSync(path.join(path.dirname(projectFile), 'cocos-sdk-spm.cjs'), { force: true });
     }
-    fs.unlinkSync(stateFile);
-    fs.rmSync(path.join(path.dirname(projectFile), 'cocos-sdk-spm.cjs'), { force: true });
   }
+
   writeProject(projectFile, project);
 }
 

package/extensions/creator2/legacy-asset-hashes.json

@@ -0,0 +1,27 @@
+[
+  "058341971ed42ddfde76c28ce19fcc0bba5020fec1f7e1c613c7bda7d2df7677",
+  "11ee16e609096ccfe90b17f61d87ab65275a39df4bef6f8c29577e7395aa00f8",
+  "15338071a78f1505265cc8efbdc9628e9362f7a2c9fc00989d57461126f8f3f5",
+  "1a51af27d68cdf0bf3ce709c9cd60f9b8a2d7defd46d06896ce9a916e1dfc767",
+  "2caa0d3d542f5cca0b6b7f3aa2851c7e296b08fce286202a844b52920b1f6dc0",
+  "3189144de638b936e14d64ddbf9d4c95e95146ceecc357021473ca8adcc757d1",
+  "48ff77a12a7b9b59172f5470a642f23e4c61e9f7e10ee6d9d3f4f41377d696ac",
+  "4d2dcd924f1073b8a6fb94d342bee33a281f93c19302104be172e5de9981b3f0",
+  "51c71e12df61cfe7e75c3d97080e31a398fbea8719a3e964cec5dd332df1202c",
+  "5f33108f27f38836214f2c11badd7bb76ba9ec090f9d5b1490834a9257976939",
+  "85ad9622480d954c33a4f9442a391f6d3d9d617a2f1261e5ad769170c6e9cf12",
+  "86cf732195aad676898520192ac8aa878267877dc09f85fcf425279d8badc9b8",
+  "910792f383c25cd46ddc7d851080a687fa532a93d605fb709b7baff9bb2789cf",
+  "95bdc516c4e1b72833af3bec13b18e3c2ac6ae83de284c3f711e97765ed1b461",
+  "a748564f0bba03effbf4aa381308f60eedcb618cbd2a37e1c67cdbee596e9ceb",
+  "a8a57b5892e7a5063078d561fce790b44d900d2bb3869e43ed4c4de82f1f62ed",
+  "cd03df57f7861d19b0a8e0a97e8aff1fa08e5c26d4f43152743968245632535b",
+  "d26fb42c6bee416eaf29bc2ed8579edc7a28ca3d0e18433dcb8abea11fac9920",
+  "d2d171e4ef1777facdb6fe665105372ea2e6452028d4c32f5e2ccc74dacc8850",
+  "d538d9eebaf181687ebf8537fc6ce7c8fae59fa424daeb45c3f900a8e210ecfc",
+  "df8e3014e583d60922cd1b7f7f16964c433b260a7e1a7e6c285cb08ce2d9e7e4",
+  "e70ca2a537cec56f8424ff4d551c1e97af133938fc7ba863a3944859dcfd194d",
+  "f0211acbaaa312bd5a4478bba81fa98293c855692ceca69f141600ff991c5904",
+  "f09f9b35ddfb17a7c4e4439384afae93ded6ee0285e778ad013d320cfc880cab",
+  "fa88198c5434613ff5ab2d44dce6e7eb8b825085b5b498402810eb144cf81f96"
+]

package/extensions/creator2/managed-assets.cjs

@@ -0,0 +1,67 @@
+'use strict';
+const fs = require('fs');
+const path = require('path');
+const { createHash } = require('crypto');
+const legacyHashes = new Set(require('./legacy-asset-hashes.json'));
+// Older combined installations predate the ownership manifest. Never leave a
+// locally modified obsolete Replay bridge compiling beside the new bridge.
+const legacyReplayNames = new Set(['FTCocosReplayImageJobs.java', 'FTCocosReplayImageJobs.h', 'FTCocosReplayImageJobs.m', 'FTReplayFileBridge.h', 'FTReplayFileWorker.h']);
+const manifestName = '.cocos-sdk-managed.json';
+const hash = bytes => createHash('sha256').update(bytes).digest('hex');
+
+function files(root) {
+  const result = [];
+  if (!fs.existsSync(root)) return result;
+  function visit(directory) {
+    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+      if (entry.name === manifestName || entry.name === '.DS_Store') continue;
+      const file = path.join(directory, entry.name);
+      if (entry.isSymbolicLink()) throw new Error(`[cocos-sdk] Refusing to copy symbolic link: ${file}`);
+      if (entry.isDirectory()) visit(file);
+      else result.push(path.relative(root, file).split(path.sep).join('/'));
+    }
+  }
+  visit(root);
+  return result;
+}
+
+/** Reconciles only files written by the SDK, preserving unrelated project assets. */
+function syncManagedDirectory(destination, sources, overrides = {}) {
+  const desired = new Map();
+  for (const { root, prefix = '' } of sources) {
+    if (!fs.existsSync(root)) throw new Error(`[cocos-sdk] Missing package assets: ${root}`);
+    for (const file of files(root)) desired.set(prefix + file, fs.readFileSync(path.join(root, file)));
+  }
+  for (const [file, content] of Object.entries(overrides)) desired.set(file, Buffer.from(content));
+  const manifest = path.join(destination, manifestName);
+  const previous = fs.existsSync(manifest) ? JSON.parse(fs.readFileSync(manifest, 'utf8')) : {};
+  const existing = files(destination);
+  const remove = [];
+  // Check every conflict before writing or deleting any managed file.
+  for (const file of existing) {
+    const digest = hash(fs.readFileSync(path.join(destination, file)));
+    const old = previous[file];
+    const next = desired.get(file);
+    const legacy = legacyHashes.has(digest);
+    if (!next && !old && !legacy && legacyReplayNames.has(path.basename(file))) {
+      throw new Error(`[cocos-sdk] Preserve or reconcile modified legacy Replay asset before reinstalling: ${path.join(destination, file)}`);
+    }
+    if ((old || next) && digest !== old && !legacy && (!next || digest !== hash(next))) {
+      throw new Error(`[cocos-sdk] Preserve or reconcile modified SDK asset before reinstalling: ${path.join(destination, file)}`);
+    }
+    if (!next && (old || legacy) && !file.endsWith('.meta')) remove.push(file);
+  }
+  fs.mkdirSync(destination, { recursive: true });
+  for (const file of remove) fs.unlinkSync(path.join(destination, file));
+  const nextManifest = {};
+  for (const [file, content] of desired) {
+    const target = path.resolve(destination, file);
+    if (!target.startsWith(path.resolve(destination) + path.sep)) throw new Error('Invalid SDK asset path');
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    if (!fs.existsSync(target) || hash(fs.readFileSync(target)) !== hash(content)) fs.writeFileSync(target, content);
+    nextManifest[file] = hash(content);
+  }
+  fs.writeFileSync(manifest, `${JSON.stringify(nextManifest, null, 2)}\n`);
+}
+
+module.exports = { syncManagedDirectory };

package/extensions/creator3/install-native.cjs

@@ -3,6 +3,7 @@
 const fs = require('fs');
 const path = require('path');
 const { execFileSync } = require('child_process');
+const { syncManagedDirectory } = require('./managed-assets.cjs');
 
 const BEGIN = '/* COCOS_SDK_BEGIN */';
 const END = '/* COCOS_SDK_END */';
@@ -28,14 +29,32 @@ function installNative(buildRoot, extensionRoot, logger = console) {
     logger.warn(`[cocos-sdk] Native bridge not found at ${nativeSource}`);
     return;
   }
+  const replayDescriptor = path.join(extensionRoot, 'replay-integration.json');
+  const replay = fs.existsSync(replayDescriptor) ? JSON.parse(fs.readFileSync(replayDescriptor, 'utf8')) : null;
+  const installedFile = path.join(extensionRoot, 'sdk-integration.json');
+  const installed = fs.existsSync(installedFile) ? JSON.parse(fs.readFileSync(installedFile, 'utf8')) : null;
+  if (installed?.replay && !replay) throw new Error('[cocos-sdk] Replay assets are missing. Run guance-cocos install --replay.');
+  if (replay && (replay.schemaVersion !== 1 || !installed || replay.baseVersion !== installed.version || replay.version !== installed.version || replay.iosSdkVersion !== '1.6.8-alpha.5')) {
+    throw new Error('[cocos-sdk] Replay native integration version does not match the base SDK. Reinstall matching packages.');
+  }
+  const replaySource = path.join(extensionRoot, 'replay-native');
   const buildNative = path.join(buildRoot, 'cocos-sdk-native');
-  copyDirectory(nativeSource, buildNative);
-  const files = findFiles(buildRoot, 7);
-  const replayHeader = path.join(buildNative, 'shared', 'FTReplayFileBridge.h');
-  if (fs.existsSync(replayHeader)) {
-    findReplayEntryFiles(files)
-      .forEach((file) => patchReplayFileBridge(file, replayHeader));
+  const sources = [{ root: nativeSource }];
+  if (replay) sources.push({ root: replaySource, prefix: 'replay/' });
+  if (dependencyManager === 'spm') {
+    sources.push({ root: path.join(nativeSource, 'ios'), prefix: 'FTCocosBridge/' });
+    if (replay) sources.push({ root: path.join(replaySource, 'ios'), prefix: 'FTCocosReplayBridge/' });
   }
+  const modules = 'android/src/main/java/com/ft/sdk/cocos/FTCocosBridgeModules.java';
+  const dispatcher = fs.readFileSync(path.join(nativeSource, modules), 'utf8');
+  const configuredDispatcher = replay ? dispatcher.replace(
+    '        return "{',
+    '        if ("session-replay".equals(endpoint)) return FTCocosReplayBridge.invokeLocal(method, payload);\n        return "{',
+  ) : dispatcher;
+  syncManagedDirectory(buildNative, sources, { [modules]: configuredDispatcher });
+  const files = findFiles(buildRoot, 7);
+  const replayHeader = replay ? path.join(buildNative, 'replay', 'shared', 'FTReplayFileBridge.h') : null;
+  findReplayEntryFiles(files).forEach(file => patchReplayFileBridge(file, replayHeader));
   const gradlePropertiesFiles = files.filter((file) => path.basename(file) === 'gradle.properties');
   const gradleFiles = uniqueFiles([
     ...files.filter((file) => /(?:^|\/)app\/build\.gradle$/.test(normalize(file))),
@@ -50,7 +69,6 @@ function installNative(buildRoot, extensionRoot, logger = console) {
     .filter((project) => project.target);
   if (dependencyManager === 'spm' && iosApplicationProjects.length > 0) {
     migrateManagedPods(podfiles, logger);
-    copyDirectory(path.join(nativeSource, 'ios'), path.join(buildNative, 'FTCocosBridge'));
   }
   if (dependencyManager === 'cocoapods' && podfiles.length === 0) {
     iosApplicationProjects.forEach(({ projectFile, target }) => {
@@ -63,14 +81,18 @@ function installNative(buildRoot, extensionRoot, logger = console) {
   iosApplicationProjects.forEach(({ projectFile, target }) => {
     patchCocos2IosConfiguration(projectFile, target);
     if (dependencyManager === 'spm') {
-      require('./install-spm.cjs').installSwiftPackage(projectFile, path.join(buildNative, 'FTCocosBridge'), 'FTCocosBridge', target);
-    } else if (fs.readFileSync(projectFile, 'utf8').includes('XCLocalSwiftPackageReference')) {
+      const spm = require('./install-spm.cjs');
+      if (!replay) spm.removeSwiftPackages(projectFile, ['FTCocosReplayBridge']);
+      spm.installSwiftPackage(projectFile, path.join(buildNative, 'FTCocosBridge'), 'FTCocosBridge', target);
+      if (replay) spm.installSwiftPackage(projectFile, path.join(buildNative, 'FTCocosReplayBridge'), 'FTCocosReplayBridge', target);
+    } else if (fs.readFileSync(projectFile, 'utf8').includes('XCLocalSwiftPackageReference')
+      || fs.existsSync(path.join(path.dirname(projectFile), 'cocos-sdk-spm.json'))) {
       require('./install-spm.cjs').removeSwiftPackages(projectFile);
     }
   });
-  gradleFiles.forEach((file) => patchGradle(file, buildNative));
+  gradleFiles.forEach((file) => patchGradle(file, buildNative, replay));
   gradlePropertiesFiles.forEach(patchGradleProperties);
-  if (dependencyManager === 'cocoapods') podfiles.forEach((file) => patchPodfile(file, buildNative));
+  if (dependencyManager === 'cocoapods') podfiles.forEach((file) => patchPodfile(file, buildNative, replay));
   logger.info(
     `[cocos-sdk] Installed native bridge (${gradleFiles.length} Android, ${dependencyManager === 'spm' ? iosApplicationProjects.length : podfiles.length} iOS project files; iOS: ${dependencyManager}).`,
   );
@@ -85,6 +107,12 @@ function patchReplayFileBridge(file, header) {
   // Creator 3 shares Game.cpp across iOS/Android builds. Keep its include stable
   // when another platform's build directory is cleaned or regenerated.
   const sharedDirectory = path.join(path.dirname(file), 'cocos-sdk-replay');
+  if (!header) {
+    const next = original.replace(markedPattern(includeBegin, includeEnd), '').replace(markedPattern(initBegin, initEnd), '');
+    if (fs.existsSync(sharedDirectory)) syncManagedDirectory(sharedDirectory, []);
+    if (next !== original) fs.writeFileSync(file, next);
+    return;
+  }
   const include = `${includeBegin}\n#include "cocos-sdk-replay/FTReplayFileBridge.h"\n${includeEnd}`;
   const init = `${initBegin}\n    ft_cocos::installReplayFileBridge();\n    ${initEnd}\n    `;
   let next = original;
@@ -100,7 +128,7 @@ function patchReplayFileBridge(file, header) {
   next = markedPattern(includeBegin, includeEnd).test(next)
     ? next.replace(markedPattern(includeBegin, includeEnd), include)
     : `${include}\n${next}`;
-  copyDirectory(path.dirname(header), sharedDirectory);
+  syncManagedDirectory(sharedDirectory, [{ root: path.dirname(header) }]);
   if (next !== original) fs.writeFileSync(file, next);
 }
 
@@ -251,12 +279,14 @@ function compareVersions(left, right) {
   return 0;
 }
 
-function patchGradle(file, nativeRoot) {
+function patchGradle(file, nativeRoot, replay) {
   const javaDir = normalize(path.join(nativeRoot, 'android', 'src', 'main', 'java'));
+  const javaDirs = [javaDir];
+  if (replay) javaDirs.push(normalize(path.join(nativeRoot, 'replay', 'android', 'src', 'main', 'java')));
   replaceMarkedBlock(file, [
     BEGIN,
     'android {',
-    `    sourceSets { main.java.srcDirs += ['${escapeGroovy(javaDir)}'] }`,
+    `    sourceSets { main.java.srcDirs += [${javaDirs.map(dir => `'${escapeGroovy(dir)}'`).join(', ')}] }`,
     '}',
     'repositories {',
     "    maven { url 'https://mvnrepo.guance.com/repository/maven-releases' }",
@@ -264,21 +294,22 @@ function patchGradle(file, nativeRoot) {
     'dependencies {',
     "    implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-sdk:1.7.6-alpha03'",
     "    implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-native:1.1.3'",
-    "    implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-session-replay:0.1.9-alpha03'",
+    ...(replay ? [`    implementation '${escapeGroovy(replay.androidReplay)}'`] : []),
     "    implementation 'com.google.code.gson:gson:2.10.1'",
     "    implementation platform('org.jetbrains.kotlin:kotlin-bom:1.8.22')",
     "    implementation 'androidx.appcompat:appcompat:1.1.0'",
-    "    implementation 'androidx.fragment:fragment:1.8.0'",
+    ...(replay ? [`    implementation '${escapeGroovy(replay.androidFragment)}'`] : []),
     '}',
     END,
   ].join('\n'), BEGIN, END, [[LEGACY_BEGIN, LEGACY_END]]);
 }
 
-function patchPodfile(file, nativeRoot) {
+function patchPodfile(file, nativeRoot, replay) {
   const iosDir = normalize(path.join(nativeRoot, 'ios'));
   const block = [
     POD_BEGIN,
     `pod 'FTCocosBridge', :path => '${escapeRuby(iosDir)}'`,
+    ...(replay ? [`pod 'FTCocosReplayBridge', :path => '${escapeRuby(normalize(path.join(nativeRoot, 'replay', 'ios')))}'`] : []),
     POD_END,
   ].join('\n');
   const original = fs.readFileSync(file, 'utf8');
@@ -308,7 +339,8 @@ function replaceIndentedMarkedBlock(contents, begin, end, block) {
 
 function findIosApplicationTarget(projectFile) {
   const contents = fs.readFileSync(projectFile, 'utf8');
-  if (contents.includes('COCOS_SDK_XCODE_PROJECT')) {
+  if (contents.includes('COCOS_SDK_XCODE_PROJECT')
+    || fs.existsSync(path.join(path.dirname(projectFile), 'cocos-sdk-spm.json'))) {
     const { readProject, applicationTarget } = require('./install-spm.cjs');
     return applicationTarget(readProject(projectFile))?.[1].name || null;
   }
@@ -366,16 +398,6 @@ function markedPattern(begin, end) {
   return new RegExp(`${escapeRegExp(begin)}[\\s\\S]*?${escapeRegExp(end)}`, 'm');
 }
 
-function copyDirectory(source, destination) {
-  fs.mkdirSync(destination, { recursive: true });
-  for (const entry of fs.readdirSync(source, { withFileTypes: true })) {
-    const from = path.join(source, entry.name);
-    const to = path.join(destination, entry.name);
-    if (entry.isDirectory()) copyDirectory(from, to);
-    else fs.copyFileSync(from, to);
-  }
-}
-
 function findFiles(root, maxDepth) {
   const result = [];
   function visit(directory, depth) {
@@ -425,14 +447,14 @@ function migrateManagedPods(podfiles, logger) {
       [POD_BEGIN, POD_END], [LEGACY_POD_BEGIN, LEGACY_POD_END], [LEGACY_BEGIN, LEGACY_END],
       ['# COCOS_HYBRID_SAMPLE_BEGIN', '# COCOS_HYBRID_SAMPLE_END'],
     ]) next = next.replace(markedPattern(begin, end), '');
-    if (/^\s*pod\s+['"](?:FTCocosBridge|HybridSampleHost|GuanceSDK)(?:\/[^'"]*)?['"]/m.test(next)) {
+    if (/^\s*pod\s+['"](?:FTCocosBridge|FTCocosReplayBridge|HybridSampleHost|GuanceSDK)(?:\/[^'"]*)?['"]/m.test(next)) {
       throw new Error(`[cocos-sdk] Remove the manually declared native SDK Pod from ${file} before switching to SPM.`);
     }
     if (next !== original) fs.writeFileSync(file, next);
     const directory = path.dirname(file);
     const existingLock = path.join(directory, 'Podfile.lock');
     const hasSDKPods = fs.existsSync(existingLock)
-      && /^\s*- (?:FTCocosBridge|HybridSampleHost|GuanceSDK)(?:\/|\s|:)/m.test(fs.readFileSync(existingLock, 'utf8'));
+      && /^\s*- (?:FTCocosBridge|FTCocosReplayBridge|HybridSampleHost|GuanceSDK)(?:\/|\s|:)/m.test(fs.readFileSync(existingLock, 'utf8'));
     if (next === original && !hasSDKPods) continue;
     if (fs.existsSync(path.join(directory, 'Podfile.lock')) || fs.existsSync(path.join(directory, 'Pods'))) {
       logger.info('[cocos-sdk] Updating existing Pods integration for the SPM switch.');