@cloudcare/cocos-sdk 0.1.0-alpha.1

package/dist/creator3/creator3/capture.js

@@ -0,0 +1,117 @@
+import { Camera, Director, EditBox, RenderTexture, UITransform, director, native, sys, view } from 'cc';
+import { frameFingerprint } from '../core/replay.js';
+import { waitForRenderTextureReadback } from './replay-render-cycle.js';
+export class FTCreator3CanvasCapture {
+    constructor() {
+        this.privacy = new Map();
+    }
+    setCamera(camera) {
+        this.camera = camera;
+    }
+    setPrivacy(node, mode) {
+        if (mode === 'unmask')
+            this.privacy.delete(node);
+        else
+            this.privacy.set(node, mode);
+    }
+    getViewportSize() {
+        var _a;
+        const visible = ((_a = view.getVisibleSizeInPixel) === null || _a === void 0 ? void 0 : _a.call(view)) || view.getVisibleSize();
+        return visible ? { width: visible.width, height: visible.height } : undefined;
+    }
+    async capture(maxImageDimension) {
+        var _a, _b;
+        const camera = this.camera || ((_a = director.getScene()) === null || _a === void 0 ? void 0 : _a.getComponentInChildren(Camera));
+        if (!camera)
+            return undefined;
+        const visible = this.getViewportSize();
+        if (!visible)
+            return undefined;
+        const scale = Math.min(1, maxImageDimension / Math.max(visible.width, visible.height));
+        const width = Math.max(1, Math.round(visible.width * scale));
+        const height = Math.max(1, Math.round(visible.height * scale));
+        const texture = new RenderTexture();
+        texture.reset({ width, height });
+        const previous = camera.targetTexture;
+        let pixels;
+        try {
+            camera.targetTexture = texture;
+            await waitForRenderTextureReadback(completeDrawCycle);
+            pixels = texture.readPixels(0, 0, width, height);
+        }
+        finally {
+            camera.targetTexture = previous;
+            texture.destroy();
+        }
+        if (!pixels)
+            return undefined;
+        // Metal returns top-down pixels on iOS. OpenGL/Vulkan-backed native
+        // targets use a bottom-left origin and need row reversal for PNG output.
+        if (sys.os !== ((_b = sys.OS) === null || _b === void 0 ? void 0 : _b.IOS))
+            flipRows(pixels, width, height);
+        return {
+            rgba: pixels,
+            width,
+            height,
+            timestamp: Date.now(),
+            privacyRegions: this.collectPrivacyRegions(width, height, visible.width, visible.height),
+        };
+    }
+    async persist(frame, fingerprint = frameFingerprint(frame.rgba)) {
+        const path = `${native.fileUtils.getWritablePath()}cocos-sdk-replay-${fingerprint}.rgba`;
+        if (!native.fileUtils.writeDataToFile(frame.rgba, path)) {
+            throw new Error(`Unable to persist replay frame: ${path}`);
+        }
+        return { path, width: frame.width, height: frame.height, timestamp: frame.timestamp, fingerprint };
+    }
+    disposeStoredFrame(frame) {
+        if (native.fileUtils.isFileExist(frame.path))
+            native.fileUtils.removeFile(frame.path);
+    }
+    collectPrivacyRegions(width, height, sourceWidth, sourceHeight) {
+        var _a, _b;
+        const nodes = new Map(this.privacy);
+        (_b = (_a = director.getScene()) === null || _a === void 0 ? void 0 : _a.getComponentsInChildren(EditBox)) === null || _b === void 0 ? void 0 : _b.forEach((editBox) => {
+            if (!nodes.has(editBox.node))
+                nodes.set(editBox.node, 'mask');
+        });
+        const scaleX = width / sourceWidth;
+        const scaleY = height / sourceHeight;
+        const regions = [];
+        nodes.forEach((mode, node) => {
+            var _a, _b, _c;
+            const bounds = (_c = (_b = (_a = node === null || node === void 0 ? void 0 : node.getComponent) === null || _a === void 0 ? void 0 : _a.call(node, UITransform)) === null || _b === void 0 ? void 0 : _b.getBoundingBoxToWorld) === null || _c === void 0 ? void 0 : _c.call(_b);
+            if (!bounds)
+                return;
+            regions.push({
+                x: bounds.x * scaleX,
+                y: height - (bounds.y + bounds.height) * scaleY,
+                width: bounds.width * scaleX,
+                height: bounds.height * scaleY,
+                mode: mode === 'hide' ? 'hide' : 'mask',
+            });
+        });
+        return regions;
+    }
+}
+async function completeDrawCycle() {
+    // capture() may run after the current frame's render graph has already been
+    // prepared. Waiting only for EVENT_AFTER_DRAW can then read the newly bound
+    // RenderTexture before the camera has rendered into it, producing a black
+    // FullSnapshot at a Native -> Cocos boundary. Start at the next draw boundary
+    // so the target texture is guaranteed to participate in a complete frame.
+    await new Promise((resolve) => director.once(Director.EVENT_BEFORE_DRAW, resolve));
+    await new Promise((resolve) => director.once(Director.EVENT_AFTER_DRAW, resolve));
+}
+function flipRows(bytes, width, height) {
+    const rowSize = width * 4;
+    const swap = new Uint8Array(rowSize);
+    for (let top = 0, bottom = height - 1; top < bottom; top += 1, bottom -= 1) {
+        const topOffset = top * rowSize;
+        const bottomOffset = bottom * rowSize;
+        swap.set(bytes.subarray(topOffset, topOffset + rowSize));
+        bytes.copyWithin(topOffset, bottomOffset, bottomOffset + rowSize);
+        bytes.set(swap, bottomOffset);
+    }
+}
+//# sourceMappingURL=capture.js.map

package/dist/creator3/creator3/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../../../../src/creator3/capture.ts"],"names":[],"mappings":"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"}

package/dist/creator3/creator3/index.d.ts

@@ -0,0 +1,12 @@
+import { FTCocosSDK } from '../core/client.js';
+/** Shared SDK entry point for Cocos Creator 3.x applications. */
+export declare const guanceSdk: FTCocosSDK;
+/**
+ * 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 declare function setReplayCamera(camera: unknown): void;
+export * from '../core/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/creator3/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAgB/C,iEAAiE;AACjE,eAAO,MAAM,SAAS,YAA0D,CAAC;AAEjF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAErD;AAED,cAAc,kBAAkB,CAAC"}

package/dist/creator3/creator3/index.js

@@ -0,0 +1,23 @@
+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 * from '../core/index.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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"}

package/dist/creator3/creator3/replay-render-cycle.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Waits until a newly attached native RenderTexture is safe to read back.
+ *
+ * Creator 3 can submit the first draw while the target attachment is still
+ * being applied by the native renderer. Keeping the target attached for a
+ * second complete draw prevents an empty first Session Replay snapshot.
+ */
+export declare function waitForRenderTextureReadback(drawCycle: () => Promise<void>): Promise<void>;
+//# sourceMappingURL=replay-render-cycle.d.ts.map

package/dist/creator3/creator3/replay-render-cycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-render-cycle.d.ts","sourceRoot":"","sources":["../../../../../src/creator3/replay-render-cycle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhG"}

package/dist/creator3/creator3/replay-render-cycle.js

@@ -0,0 +1,12 @@
+/**
+ * Waits until a newly attached native RenderTexture is safe to read back.
+ *
+ * Creator 3 can submit the first draw while the target attachment is still
+ * being applied by the native renderer. Keeping the target attached for a
+ * second complete draw prevents an empty first Session Replay snapshot.
+ */
+export async function waitForRenderTextureReadback(drawCycle) {
+    await drawCycle();
+    await drawCycle();
+}
+//# sourceMappingURL=replay-render-cycle.js.map

package/dist/creator3/creator3/replay-render-cycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-render-cycle.js","sourceRoot":"","sources":["../../../../../src/creator3/replay-render-cycle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,SAA8B;IAC/E,MAAM,SAAS,EAAE,CAAC;IAClB,MAAM,SAAS,EAAE,CAAC;AACpB,CAAC"}

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

@@ -0,0 +1,8 @@
+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';
+    constructor();
+    invoke<T = FTValue>(method: string, payload?: unknown): T | undefined;
+}
+//# sourceMappingURL=transport.d.ts.map

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

@@ -0,0 +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;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

@@ -0,0 +1,24 @@
+import { native, sys } from 'cc';
+import { NATIVE } from 'cc/env';
+import { parseTransportResponse } from '../core/transport.js';
+export class FTCreator3Transport {
+    constructor() {
+        this.platform = !NATIVE
+            ? 'unsupported'
+            : sys.os === sys.OS.ANDROID
+                ? 'android'
+                : sys.os === sys.OS.IOS
+                    ? 'ios'
+                    : 'unsupported';
+    }
+    invoke(method, payload) {
+        if (this.platform === 'unsupported')
+            return undefined;
+        const json = payload === undefined ? '{}' : JSON.stringify(payload);
+        const raw = this.platform === 'android'
+            ? native.reflection.callStaticMethod('com/ft/sdk/cocos/FTCocosBridge', 'invoke', '(Ljava/lang/String;Ljava/lang/String;)Ljava/lang/String;', method, json)
+            : native.reflection.callStaticMethod('FTCocosBridge', 'invoke:payload:', method, json);
+        return parseTransportResponse(raw);
+    }
+}
+//# sourceMappingURL=transport.js.map

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

@@ -0,0 +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;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/dist/creator3/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/extensions/creator2/install-native.cjs

@@ -0,0 +1,333 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { execFileSync } = require('child_process');
+
+const BEGIN = '/* COCOS_SDK_BEGIN */';
+const END = '/* COCOS_SDK_END */';
+const POD_BEGIN = '# COCOS_SDK_BEGIN';
+const POD_END = '# COCOS_SDK_END';
+const XCCONFIG_BEGIN = '// COCOS_SDK_BEGIN';
+const XCCONFIG_END = '// COCOS_SDK_END';
+const LEGACY_BEGIN = '/* FT_COCOS_SDK_BEGIN */';
+const LEGACY_END = '/* FT_COCOS_SDK_END */';
+const LEGACY_POD_BEGIN = '# FT_COCOS_SDK_BEGIN';
+const LEGACY_POD_END = '# FT_COCOS_SDK_END';
+const LEGACY_XCCONFIG_BEGIN = '// FT_COCOS_SDK_BEGIN';
+const LEGACY_XCCONFIG_END = '// FT_COCOS_SDK_END';
+
+function installNative(buildRoot, extensionRoot, logger = console) {
+  if (!buildRoot) return;
+  buildRoot = path.resolve(buildRoot);
+  extensionRoot = path.resolve(extensionRoot);
+  if (!fs.existsSync(buildRoot)) return;
+  const nativeSource = path.join(extensionRoot, 'native');
+  if (!fs.existsSync(nativeSource)) {
+    logger.warn(`[cocos-sdk] Native bridge not found at ${nativeSource}`);
+    return;
+  }
+  const buildNative = path.join(buildRoot, 'cocos-sdk-native');
+  copyDirectory(nativeSource, buildNative);
+  const files = findFiles(buildRoot, 7);
+  const gradlePropertiesFiles = files.filter((file) => path.basename(file) === 'gradle.properties');
+  const gradleFiles = uniqueFiles([
+    ...files.filter((file) => /(?:^|\/)app\/build\.gradle$/.test(normalize(file))),
+    ...gradlePropertiesFiles.flatMap(findNativeAppGradleFiles),
+  ]);
+  const podfiles = files.filter((file) => path.basename(file) === 'Podfile');
+  const xcodeProjects = files.filter((file) => (
+    path.basename(file) === 'project.pbxproj' && path.extname(path.dirname(file)) === '.xcodeproj'
+  ));
+  const iosApplicationProjects = xcodeProjects
+    .map((projectFile) => ({ projectFile, target: findIosApplicationTarget(projectFile) }))
+    .filter((project) => project.target);
+  if (podfiles.length === 0) {
+    iosApplicationProjects.forEach(({ projectFile, target }) => {
+      const projectDirectory = path.dirname(path.dirname(projectFile));
+      const podfile = path.join(projectDirectory, 'Podfile');
+      if (!fs.existsSync(podfile)) createPodfile(podfile, projectFile, target);
+      podfiles.push(podfile);
+    });
+  }
+  iosApplicationProjects.forEach(({ projectFile, target }) => {
+    patchCocos2IosConfiguration(projectFile, target);
+  });
+  gradleFiles.forEach((file) => patchGradle(file, buildNative));
+  gradlePropertiesFiles.forEach(patchGradleProperties);
+  podfiles.forEach((file) => patchPodfile(file, buildNative));
+  logger.info(
+    `[cocos-sdk] Installed native bridge (${gradleFiles.length} Android, ${podfiles.length} iOS project files).`,
+  );
+}
+
+function patchCocos2IosConfiguration(projectFile, target) {
+  const projectDirectory = path.dirname(path.dirname(projectFile));
+  const iosDirectory = path.join(projectDirectory, 'ios');
+  const configurations = ['debug', 'release'];
+  const configFiles = configurations.map((configuration) => ({
+    configuration,
+    file: path.join(iosDirectory, `UserConfigIOS.${configuration}.xcconfig`),
+  }));
+  if (!configFiles.some(({ file }) => fs.existsSync(file))) return;
+
+  configFiles.forEach(({ configuration, file }) => {
+    if (!fs.existsSync(file)) return;
+    replaceMarkedBlock(file, [
+      XCCONFIG_BEGIN,
+      `#include? "../Pods/Target Support Files/Pods-${target}/Pods-${target}.${configuration}.xcconfig"`,
+      `OTHER_LDFLAGS = $(inherited) ${cocos2CompatibilityLinkerFlags()}`,
+      XCCONFIG_END,
+    ].join('\n'), XCCONFIG_BEGIN, XCCONFIG_END, [
+      [LEGACY_XCCONFIG_BEGIN, LEGACY_XCCONFIG_END],
+    ]);
+  });
+
+  const original = fs.readFileSync(projectFile, 'utf8');
+  let next = quoteWhitespaceProductNames(original).replace(
+    /(\b(?:HEADER|LIBRARY)_SEARCH_PATHS\s*=\s*)"([^"]*)";/g,
+    (line, prefix, value) => value.includes('$(inherited)')
+      ? line
+      : `${prefix}"${`$(inherited) ${value}`.trim()}";`,
+  );
+  next = next.replace(
+    /(\bIPHONEOS_DEPLOYMENT_TARGET\s*=\s*)(\d+(?:\.\d+)*)(\s*;)/g,
+    (line, prefix, version, suffix) => compareVersions(version, '12.0') < 0
+      ? `${prefix}12.0${suffix}`
+      : line,
+  );
+  if (next !== original) fs.writeFileSync(projectFile, next);
+}
+
+function quoteWhitespaceProductNames(contents) {
+  return contents.replace(
+    /^([ \t]*productName[ \t]*=)([^;\r\n]*)(;)$/gm,
+    (line, prefix, value, suffix) => {
+      const productName = value.trim();
+      if (!/[ \t]/.test(productName) || (productName.startsWith('"') && productName.endsWith('"'))) {
+        return line;
+      }
+      const spacing = value.match(/^[ \t]*/)?.[0] || ' ';
+      return `${prefix}${spacing}"${productName.replace(/"/g, '\\"')}"${suffix}`;
+    },
+  );
+}
+
+function cocos2CompatibilityLinkerFlags() {
+  const flags = ['-lwebp'];
+  if (process.platform !== 'darwin') return flags.join(' ');
+  try {
+    const version = execFileSync('xcodebuild', ['-version'], { encoding: 'utf8' });
+    const major = Number((version.match(/^Xcode\s+(\d+)/m) || [])[1]);
+    if (major >= 15) flags.push('-Wl,-ld_classic');
+  } catch {
+    // Xcode is optional when only generating or testing non-iOS projects.
+  }
+  return flags.join(' ');
+}
+
+function patchGradleProperties(file) {
+  let contents = fs.readFileSync(file, 'utf8');
+  contents = raiseNumericProperty(contents, 'PROP_COMPILE_SDK_VERSION', 34);
+  contents = raiseNumericProperty(contents, 'PROP_MIN_SDK_VERSION', 21);
+  contents = raiseNumericProperty(contents, 'PROP_TARGET_SDK_VERSION', 34);
+  contents = raiseVersionProperty(contents, 'PROP_BUILD_TOOLS_VERSION', '34.0.0');
+  contents = enableBooleanProperty(contents, 'android.useAndroidX');
+  if (contents !== fs.readFileSync(file, 'utf8')) fs.writeFileSync(file, contents);
+}
+
+function findNativeAppGradleFiles(propertiesFile) {
+  const contents = fs.readFileSync(propertiesFile, 'utf8');
+  const nativeDirectoryValue = readProperty(contents, 'NATIVE_DIR');
+  if (!nativeDirectoryValue) return [];
+  const nativeDirectory = path.isAbsolute(nativeDirectoryValue)
+    ? nativeDirectoryValue
+    : path.resolve(path.dirname(propertiesFile), nativeDirectoryValue);
+  const gradleFile = path.join(nativeDirectory, 'app', 'build.gradle');
+  return fs.existsSync(gradleFile) ? [gradleFile] : [];
+}
+
+function readProperty(contents, key) {
+  const match = contents.match(new RegExp(`^\\s*${escapeRegExp(key)}\\s*=\\s*(.+?)\\s*$`, 'm'));
+  return match && match[1] ? match[1].trim() : null;
+}
+
+function uniqueFiles(files) {
+  return [...new Set(files.map((file) => path.resolve(file)))];
+}
+
+function enableBooleanProperty(contents, key) {
+  const pattern = new RegExp(`^(\\s*${escapeRegExp(key)}\\s*=\\s*)(?:true|false)(\\s*)$`, 'mi');
+  if (pattern.test(contents)) {
+    return contents.replace(pattern, (line, prefix, suffix) => `${prefix}true${suffix}`);
+  }
+  return `${contents.replace(/\s*$/, '')}\n${key}=true\n`;
+}
+
+function raiseNumericProperty(contents, key, minimum) {
+  const pattern = new RegExp(`^(\\s*${escapeRegExp(key)}\\s*=\\s*)(-?\\d+)(\\s*)$`, 'm');
+  return contents.replace(pattern, (line, prefix, value, suffix) => (
+    Number(value) < minimum ? `${prefix}${minimum}${suffix}` : line
+  ));
+}
+
+function raiseVersionProperty(contents, key, minimum) {
+  const pattern = new RegExp(`^(\\s*${escapeRegExp(key)}\\s*=\\s*)(\\d+(?:\\.\\d+)*)(\\s*)$`, 'm');
+  return contents.replace(pattern, (line, prefix, value, suffix) => (
+    compareVersions(value, minimum) < 0 ? `${prefix}${minimum}${suffix}` : line
+  ));
+}
+
+function compareVersions(left, right) {
+  const leftParts = left.split('.').map(Number);
+  const rightParts = right.split('.').map(Number);
+  const length = Math.max(leftParts.length, rightParts.length);
+  for (let index = 0; index < length; index += 1) {
+    const difference = (leftParts[index] || 0) - (rightParts[index] || 0);
+    if (difference !== 0) return difference;
+  }
+  return 0;
+}
+
+function patchGradle(file, nativeRoot) {
+  const javaDir = normalize(path.join(nativeRoot, 'android', 'src', 'main', 'java'));
+  replaceMarkedBlock(file, [
+    BEGIN,
+    'android {',
+    `    sourceSets { main.java.srcDirs += ['${escapeGroovy(javaDir)}'] }`,
+    '}',
+    'repositories {',
+    "    maven { url 'https://mvnrepo.guance.com/repository/maven-releases' }",
+    '}',
+    'dependencies {',
+    "    implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-sdk:1.7.6-alpha01'",
+    "    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-alpha01'",
+    "    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'",
+    '}',
+    END,
+  ].join('\n'), BEGIN, END, [[LEGACY_BEGIN, LEGACY_END]]);
+}
+
+function patchPodfile(file, nativeRoot) {
+  const iosDir = normalize(path.join(nativeRoot, 'ios'));
+  const block = [
+    POD_BEGIN,
+    `pod 'FTCocosBridge', :path => '${escapeRuby(iosDir)}'`,
+    POD_END,
+  ].join('\n');
+  const original = fs.readFileSync(file, 'utf8');
+  const currentPattern = markedPattern(POD_BEGIN, POD_END);
+  const legacyPodPattern = markedPattern(LEGACY_POD_BEGIN, LEGACY_POD_END);
+  const legacyPattern = markedPattern(LEGACY_BEGIN, LEGACY_END);
+  let next;
+  if (currentPattern.test(original)) {
+    next = replaceIndentedMarkedBlock(original, POD_BEGIN, POD_END, block);
+  } else if (legacyPodPattern.test(original)) {
+    next = replaceIndentedMarkedBlock(original, LEGACY_POD_BEGIN, LEGACY_POD_END, block);
+  } else if (legacyPattern.test(original)) {
+    next = replaceIndentedMarkedBlock(original, LEGACY_BEGIN, LEGACY_END, block);
+  } else {
+    const targetPattern = /(^[ \t]*target\s+['"][^'"]+['"]\s+do\s*$)/m;
+    next = targetPattern.test(original)
+      ? original.replace(targetPattern, `$1\n  ${block.replace(/\n/g, '\n  ')}`)
+      : `${original.replace(/\s*$/, '')}\n\n${block}\n`;
+  }
+  if (next !== original) fs.writeFileSync(file, next);
+}
+
+function replaceIndentedMarkedBlock(contents, begin, end, block) {
+  const pattern = new RegExp(`(^[\\t ]*)${escapeRegExp(begin)}[\\s\\S]*?${escapeRegExp(end)}`, 'm');
+  return contents.replace(pattern, (match, indent) => `${indent}${block.replace(/\n/g, `\n${indent}`)}`);
+}
+
+function findIosApplicationTarget(projectFile) {
+  const contents = fs.readFileSync(projectFile, 'utf8');
+  const nativeTarget = /\/\* ([^*]+) \*\/ = \{\s*isa = PBXNativeTarget;([\s\S]*?)\n\s*\};/g;
+  const targets = [];
+  let match;
+  while ((match = nativeTarget.exec(contents))) {
+    if (!/productType = ["']?com\.apple\.product-type\.application["']?;/.test(match[2])) continue;
+    const nameMatch = match[2].match(/\n\s*name = ("(?:[^"\\]|\\.)*"|[^;]+);/);
+    targets.push(unquotePbxValue(nameMatch ? nameMatch[1] : match[1]));
+  }
+  return targets.find((target) => /(?:^|[-_.])mobile$/i.test(target))
+    || targets.find((target) => /(?:^|[-_.])ios(?:$|[-_.])/i.test(target))
+    || targets[0]
+    || null;
+}
+
+function unquotePbxValue(value) {
+  const trimmed = value.trim();
+  return trimmed.startsWith('"') && trimmed.endsWith('"')
+    ? trimmed.slice(1, -1).replace(/\\"/g, '"')
+    : trimmed;
+}
+
+function createPodfile(file, projectFile, target) {
+  const projectName = path.basename(path.dirname(projectFile));
+  fs.writeFileSync(file, [
+    "platform :ios, '12.0'",
+    `project '${escapeRuby(projectName)}'`,
+    '',
+    `target '${escapeRuby(target)}' do`,
+    'end',
+    '',
+  ].join('\n'));
+}
+
+function replaceMarkedBlock(file, block, begin = BEGIN, end = END, legacyMarkers = []) {
+  const original = fs.readFileSync(file, 'utf8');
+  const pattern = markedPattern(begin, end);
+  let next;
+  if (pattern.test(original)) {
+    next = original.replace(pattern, block);
+  } else {
+    const legacy = legacyMarkers.find(([legacyBegin, legacyEnd]) => (
+      markedPattern(legacyBegin, legacyEnd).test(original)
+    ));
+    next = legacy
+      ? original.replace(markedPattern(legacy[0], legacy[1]), block)
+      : `${original.replace(/\s*$/, '')}\n\n${block}\n`;
+  }
+  if (next !== original) fs.writeFileSync(file, next);
+}
+
+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) {
+    if (depth > maxDepth) return;
+    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+      if (entry.name === 'node_modules' || entry.name === '.git') continue;
+      const child = path.join(directory, entry.name);
+      if (entry.isDirectory()) visit(child, depth + 1);
+      else result.push(child);
+    }
+  }
+  visit(root, 0);
+  return result;
+}
+
+function normalize(value) { return value.split(path.sep).join('/'); }
+function escapeGroovy(value) { return value.replace(/\\/g, '\\\\').replace(/'/g, "\\'"); }
+function escapeRuby(value) { return value.replace(/\\/g, '\\\\').replace(/'/g, "\\'"); }
+function escapeRegExp(value) { return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); }
+
+module.exports = { installNative };

package/extensions/creator2/main.js

@@ -0,0 +1,23 @@
+'use strict';
+
+const path = require('path');
+const { installNative } = require('./install-native.cjs');
+
+function onBuildFinished(options, callback) {
+  try {
+    installNative(options && (options.dest || options.buildPath), __dirname, Editor);
+    callback();
+  } catch (error) {
+    Editor.error(`[cocos-sdk] ${error && error.stack ? error.stack : error}`);
+    callback(error);
+  }
+}
+
+module.exports = {
+  load() {
+    Editor.Builder.on('build-finished', onBuildFinished);
+  },
+  unload() {
+    Editor.Builder.removeListener('build-finished', onBuildFinished);
+  },
+};

package/extensions/creator2/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "guance-cocos-sdk",
+  "version": "0.1.0",
+  "description": "Observability SDK native build integration for Cocos Creator",
+  "main": "main.js"
+}

package/extensions/creator3/dist/builder.js

@@ -0,0 +1,9 @@
+'use strict';
+
+exports.load = function load() {};
+exports.unload = function unload() {};
+exports.configs = {
+  '*': {
+    hooks: './hooks',
+  },
+};