更新履歴¶
0.1.0-alpha.5¶
新機能¶
- iOS Swift Package Manager 対応：Creator 2、Creator 3、Hybrid ネイティブホストはプロジェクト設定で CocoaPods または SPM を選択できます。デフォルトは引き続き CocoaPods です。インストーラーは既存の選択を保持し、Creator 3 の CMake 再生成後は SPM 参照を復元します。
改善¶
- ネイティブネットワーク SDK 依存関係：Android Agent を
1.7.6-alpha03に、Hybrid サンプルの Gradle Plugin を1.3.9-alpha01にアップグレードしました。CocoaPods と SPM で使用する iOS Agent と Session Replay は1.6.8-alpha.5にアップグレードしました。新しい iOS では、独立したスイッチで NSURLConnection Resource の収集と Trace 関連付けを有効にできます。新しく追加された 2 つのスイッチはデフォルトでオフです。 - ネットワーク検証サンプル：Creator 2 Android エンジンの HTTP リクエストと、オプションで有効化できる iOS NSURLConnection リクエストのサンプルを追加しました。実際にアップロードされる Resource を確認し、JS の自動収集や手動埋め込みがネイティブ収集と重複しないようにする方法を説明します。
- Creator 3 Replay サンプル：ネイティブ 3D 検証シーンを追加しました。カメラ、移動、独立した HUD コントロールを提供し、フレームキャプチャの動作と現在の単一カメラ収集の制限を確認するために使用します。
ネットワーク収集スイッチと重複収集の回避方法については、Android ネットワーク収集の推奨事項 と iOS ネットワーク収集の推奨事項 を参照してください。SPM 導入の手順は iOS ネイティブビルド を参照してください。
0.1.0-alpha.4¶
新機能¶
- Session Replay プライバシーコンポーネント：Creator 2 と Creator 3 に
ReplayPrivacyエディターコンポーネントを追加しました。キャプチャしたリプレイ画面でノードやプレハブをマスクまたは非表示にできます。インストーラーはコンポーネントをプロジェクトのアセットディレクトリにコピーします。コードによる上書きルールが優先され、入力ボックスはデフォルトでマスクされます。
改善¶
- Session Replay フレームキャプチャパフォーマンス：Android と iOS におけるリプレイファイルの読み書きと、ネイティブ画像エンコードをゲームスレッドから移動しました。SDK 更新後、非同期 Bridge を含めるためにネイティブプロジェクトを再ビルドする必要があります。
- Hybrid プライバシーサンプル：メンテナンス中の Creator 2 および Creator 3 Hybrid サンプルに、プライバシーコンポーネントのサンプルとマスク位置合わせテストコントロールを追加しました。
修正¶
- Android Session Replay の再生：ネイティブ依存関係インストーラーの
ft-session-replay:0.1.9-alpha02を0.1.9-alpha03にアップグレードし、セグメント圧縮を Browser SDK の形式と一致させました。これにより、影響を受けていたマルチセグメントセッションの再生が復元されます。Maven に公開された成果物を使用し、ネイティブページと Cocos ページ間で旧バージョン→新バージョン→旧バージョンに戻る比較方式で検証しました。
0.1.0-alpha.3¶
改善¶
- Android SDK 依存関係：Creator 2 と Creator 3 のネイティブ依存関係インストーラーで、Android Agent SDK を
1.7.6-alpha01から1.7.6-alpha02に、Session Replay を0.1.9-alpha01から0.1.9-alpha02にアップグレードしました。 - Hybrid 統合サンプル：各世代の Creator に最小限の Hybrid 統合プロジェクトを 1 つ保持します。メンテナンス中のサンプルから、旧診断プロジェクト、複製された SDK インストールディレクトリ、リプレイトラフィックのベンチマークツールを削除しました。
- SDK とサンプルのメッセージ：不要なブランド名を削除し、SDK のエラーメッセージとサンプルの文言を簡素化しました。
修正¶
- npm リリース：リリース前にパッケージメタデータをチェックし、バージョンが既に存在するかどうかを検出して、リリース識別子を検証します。最初の安定版がリリースされるまでは、最新のプレリリース版を
latestタグに公開します。
0.1.0-alpha.2¶
修正¶
- Session Replay プライバシーマスク：Creator 2 および Creator 3 において、Camera プロジェクションがキャプチャフレーム内のコントロールの位置やサイズを変更する際に、入力ボックスとカスタムノードのマスクがずれる問題を修正しました。プライバシー境界を確実にプロジェクションできない場合はそのフレームをスキップし、マスク位置が正しくない画面を収集しないようにします。
0.1.0-alpha.1¶
コミット 2bbeeb86270b666e5eeddc6f220586df66f10362 に基づいてリリースされました。
最初のプレリリース版であり、Android および iOS ネイティブプラットフォームで動作する Cocos Creator アプリに、リアルユーザーモニタリング（RUM）、ログ、分散型トレーシング、および実験的な Session Replay を提供します。
新機能¶
- RUM 自動収集と手動埋め込み：必要に応じて、シーン切り替え、タッチ操作、ランタイムがサポートする JavaScript エラー、未処理の Promise 拒否を収集できます。重要なビジネスプロセスを監視するために、View、Action、Error、Long Task、ネットワーク Resource を手動で記録できます。ネイティブクラッシュ、Android ANR、UI のカクつき、デバイスパフォーマンス監視を設定できます。
- ログ収集：カスタムログの送信と、必要に応じた Console 出力の収集をサポートします。ログレベルのフィルタリング、サンプリング、キャッシュポリシーを設定でき、現在の RUM セッションに関連付けて、ユーザー行動と合わせて問題を調査できます。
- ネットワーク監視とトレース関連付け：ランタイムが提供する
fetchとXMLHttpRequestの基本リクエスト、レスポンス情報、合計所要時間を自動収集し、Trace Header を注入します。カスタムネットワーク接続向けに、手動 Resource 埋め込みと Trace Header 生成をサポートします。DNS、TCP、SSL の段階別所要時間は手動埋め込みが必要です。 - Session Replay（実験的）：Cocos 画面を収集し、RUM セッションに関連付けます。サンプリング、エラーセッションの追加サンプリング、フレームキャプチャ頻度、画像サイズを設定できます。ノードのマスクと非表示をサポートします。デフォルトでは入力ボックスをマスクし、タッチ位置を非表示にします。
- リプレイ画質とトラフィック制御：画質プリセット、単一フレームのサイズ制限、スライディングウィンドウの画像データ予算を設定できます。アダプティブ収集は、予算の使用状況に応じてフレームキャプチャ頻度、画質、サイズを調整し、リプレイの詳細度とデータ使用量のバランスを取るのに役立ちます。
- ネイティブホスト Hybrid 統合：Cocos を組み込んだネイティブアプリで初期化済みの SDK を再利用します。
guanceSdk.attach()で統合し、guanceSdk.enterCocos()とguanceSdk.leaveCocos()を使用して Cocos 収集のライフサイクルを管理し、ホスト SDK の重複初期化を回避します。 - ユーザーとビジネスコンテキスト：ユーザーのバインド/アンバインド、グローバルおよびイベントレベルのカスタム属性の追加をサポートし、ユーザー、環境、ビジネスコンテキストごとにモニタリングデータをフィルタリングできます。DataKit または DataWay での送信をサポートします。
- プロジェクトインストールツール：独立した Creator 2 と Creator 3 のエントリを含む npm パッケージ、インストールコマンド、ビルド拡張機能を提供し、Android および iOS のネイティブ Bridge と依存関係の設定を支援します。
導入要件¶
- Cocos Creator 2.4.5～2.4.15 および 3.6.3～3.8.x をサポートします。3.0～3.6.2 はベストエフォートでサポートします。
- Android API 21+ または iOS 12+ が必要です。現在、Web、ミニゲーム、デスクトップターゲットはサポートしていません。
- 独立した Cocos アプリは
guanceSdk.start()で初期化します。Hybrid アプリは、まずネイティブホストで SDK を初期化してからguanceSdk.attach()を呼び出します。2 つの初期化方法は排他的です。 - 必要に応じて RUM、ログ、分散型トレーシング、Session Replay、自動収集を設定します。iOS ネイティブプロジェクト生成後、
pod installを実行して依存関係をインストールします。