diff --git a/src/content/docs/ja/sdk/android/v4/integrations/signature-library.mdx b/src/content/docs/ja/sdk/android/v4/integrations/signature-library.mdx index 242791961b..64eda9895a 100644 --- a/src/content/docs/ja/sdk/android/v4/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/android/v4/integrations/signature-library.mdx @@ -12,48 +12,76 @@ redirects: v5: /ja/sdk/android/integrations/signature-library --- + + +このページでは、Adjust SDK v4の連携手順について説明します。Adjust SDK v5をご使用の場合は、左側のドロップダウンメニューから適切なタブを選択してください。 + + + AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -## Before you begin {#before-you-begin} +## 事前準備 \{\#before\-you\-begin\} + + + +シグネチャーライブラリは、[16KBのページサイズ](https://developer.android.com/guide/practices/page-sizes)を使用するように設定されており、[バージョン3\.32\.0以降](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)で利用可能です。 + + シグネチャーライブラリをAndroidアプリに実装する前に、以下を確認してください。 -- 使用中のAndroid APIバージョンが **21以降** であること。 -- お使いのAdjust SDKバージョンが **4\.38\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 -- Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 -- [16KBのページサイズに揃えたシグネチャーライブラリ](https://developer.android.com/guide/practices/page-sizes)にご興味がある場合は、Adjustの担当者にお問い合わせいただくか、[support@adjust.com](mailto:support@adjust.com)までご連絡ください。 +- 使用中のAndroid APIバージョンが **21以降** であること。 +- お使いのAdjust SDKバージョンが **4\.38\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 +- Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 -Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 +Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。 外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +### シグネチャーv1またはv2ライブラリから移行 {#migrating-from-signature-v1-or-v2-library} 以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。 -- 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 -- 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 +- 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 +- 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -### Updating the Signature Library {#updating-the-signature-library} +## シグネチャーライブラリを実装する \{\#integrate\-the\-signature\-library\} -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/ja/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 + + -- インストールレポートに役立たなくなった。 -- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースした。 +シグネチャーライブラリは[GitHub](https://github.com/adjust/adjust_signature_sdk/releases/)でリリースされており、バージョン `3.20.1`以降はMavenに反映されています。シグネチャーライブラリをプロジェクトに追加するには、アプリレベルの`build.gradle`に以下を追加します（利用可能な[最新のバージョン](https://github.com/adjust/adjust_signature_sdk/releases/latest)に変更してください）。 -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +```groovy +dependencies { + implementation 'com.adjust.signature:adjust-android-signature:x.x.x' +} +``` - +または、ベータ版リリースはバージョン`3.24.1`以降からMavenで利用可能です。シグネチャーライブラリをプロジェクトに追加するには、プロジェクトレベルとアプリレベルの`build.gradle`にそれぞれ以下を追加します（利用可能な[最新のバージョン](https://github.com/adjust/adjust_signature_sdk/releases)に変更してください）。 -Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 +```groovy +repositories { + maven { + url "https://oss.sonatype.org/content/repositories/snapshots/" + } +... +``` - +```groovy +dependencies { + implementation 'com.adjust.signature:adjust-android-signature:x.x.x-SNAPSHOT' +} +``` + +これで、シグネチャーライブラリがプロジェクトに実装されました。Adjustでデジタル証明書を設定するには、次のセクションの手順に従ってください。 -Androidプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 + + -1. [GitHubからシグネチャーライブラリの内容](https://github.com/adjust/adjust_signature_sdk/releases/latest)を取得します。 +1. GitHubから[最新の安定版](https://github.com/adjust/adjust_signature_sdk/releases/latest)または[ベータ版](https://github.com/adjust/adjust_signature_sdk/releases)を取得します。 2. アプリモジュールディレクトリ内に新しい`libs`ディレクトリを作成します。 3. 提供されたAARライブラリを`libs`ディレクトリにコピーします。 @@ -77,7 +105,10 @@ Androidプロジェクトにシグネチャーライブラリを実装するに これで、シグネチャーライブラリがプロジェクトに実装されました。Adjustでデジタル証明書を設定するには、次のセクションの手順に従ってください。 -## Set up your certificates in the Adjust suite {#set-up-your-certificates-in-the-adjust-suite} + + + +## Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} アプリにシグネチャーライブラリを実装すると、Adjust SDKからAdjustに送信される全てのリクエストが署名されます。また、Adjust SDKは、署名証明書のフィンガープリントなどの関連情報をAdjustのサーバーに送信します。 @@ -91,7 +122,7 @@ Androidプロジェクトにシグネチャーライブラリを実装するに -#### From a keystore {#from-a-keystore} +#### キーストアから取得する {#from-a-keystore} 独自のキーストアを使用している場合、またはAndroid Studioが生成したキーストアの場合は、以下の手順に従って証明書フィンガープリントを取得できます。 @@ -105,7 +136,7 @@ Androidプロジェクトにシグネチャーライブラリを実装するに このコマンドを実行すると、キーストアのパスワードが要求されます。これは、キーストアの生成時に定義したパスワードです。 - 最終的な出力結果は、以下のようになります。 + 最終的な出力結果は以下のようになります。 ```text Alias name: Key0 @@ -132,7 +163,7 @@ Androidプロジェクトにシグネチャーライブラリを実装するに 3. SHA\-1フィンガープリントを保存し、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -#### From Google Play Internal App Sharing {#from-google-play-internal-app-sharing} +#### Google Play Internal App Sharingから取得 {#from-google-play-internal-app-sharing} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -145,7 +176,7 @@ Androidプロジェクトにシグネチャーライブラリを実装するに ![Google Play Consoleの証明書ページのスクリーンショット](@images/sig-v3/google-play-internal-sharing.png) -#### From Google Play App Signing {#from-google-play-app-signing} +#### Google Play App Signingから取得 {#from-google-play-app-signing} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用の証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -158,7 +189,7 @@ Androidプロジェクトにシグネチャーライブラリを実装するに ![Google Play ConsoleのApp Signingページのスクリーンショット](@images/sig-v3/google-play-signing.png) -#### From Huawei AppGallery App Signing {#from-huawei-appgallery-app-signing} +#### Huawei AppGallery App Signingから取得 {#from-huawei-appgallery-app-signing} Huawei AppGallery App Signingを使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -188,7 +219,7 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ 3. フィンガープリントを保存して、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -### Add your digital certificate fingerprints to Adjust’s allowlist {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### デジタル証明書フィンガープリントをAdjustの許可リストに追加する {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} @@ -207,7 +238,7 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ これで、フィンガープリントがアプリで許可リストに登録されました。 -## Test your app {#test-your-app} +## アプリをテストする \{\#test\-your\-app\} [Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 @@ -239,3 +270,10 @@ Adjust SDKが **サンドボックス** モードで実行されていること これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/ja/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 + +## シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} + +シグネチャーライブラリの更新とは、既存のライブラリを新しいバージョンに置き換え、テストを再度実行することです。Adjustでアプリのロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 + +- インストールのレポーティングに貢献していない。 +- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 diff --git a/src/content/docs/ja/sdk/android/v5/integrations/signature-library.mdx b/src/content/docs/ja/sdk/android/v5/integrations/signature-library.mdx index aa5e8006c8..345ea70610 100644 --- a/src/content/docs/ja/sdk/android/v5/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/android/v5/integrations/signature-library.mdx @@ -12,48 +12,88 @@ redirects: v4: /ja/sdk/android/v4/integrations/signature-library --- + + +このページでは、Adjust SDK v5の実装手順について説明します。Adjust SDK v4をご使用の場合は、左側のドロップダウンメニューから適切なタブを選択してください。 + + + AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -## Before you begin {#before-you-begin} +## 事前準備 \{\#before\-you\-begin\} + + + +シグネチャーライブラリは、[16KBのページサイズ](https://developer.android.com/guide/practices/page-sizes)を使用するように設定されており、[バージョン3\.32\.0以降](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)で利用可能です。 + + シグネチャーライブラリをAndroidアプリに実装する前に、以下を確認してください。 -- 使用中のAndroid APIバージョンが **21以降** であること。 -- お使いのAdjust SDKバージョンが **4\.38\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 -- Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 -- [16KBのページサイズに揃えたシグネチャーライブラリ](https://developer.android.com/guide/practices/page-sizes)にご興味がある場合は、Adjustの担当者にお問い合わせいただくか、[support@adjust.com](mailto:support@adjust.com)までご連絡ください。 +- 使用中のAndroid APIバージョンが **21以降** であること。 +- お使いのAdjust SDKバージョンが **5\.0\.0以降** であること。この要件は、Adjust SDKが間接的に使用される場合にも適用されます。 +- Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 -Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 +Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。 外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +### シグネチャーv1またはv2ライブラリから移行 {#migrating-from-signature-v1-or-v2-library} 以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。 -- 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 -- 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 +- 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 +- 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -### Updating the Signature Library {#updating-the-signature-library} +## シグネチャーライブラリを実装する \{\#integrate\-the\-signature\-library\} -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/ja/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 + -- インストールレポートに役立たなくなった。 -- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースした。 +Adjust SDKには、ほとんどの場合、デフォルトでシグネチャーライブラリが含まれています。Adjust SDKからの指示がある場合、または特定のシグネチャーライブラリバージョンが必要な場合にのみ実行してください。 -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} + + - +シグネチャーライブラリは[GitHub](https://github.com/adjust/adjust_signature_sdk/releases/)でリリースされており、バージョン `3.20.1`以降はMavenに反映されています。シグネチャーライブラリをプロジェクトに追加するには、アプリレベルの`build.gradle`に以下を追加します（利用可能な[最新のバージョン](https://github.com/adjust/adjust_signature_sdk/releases/latest)に変更してください）。 -Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 +```groovy +dependencies { + implementation('com.adjust.sdk:adjust-android:5.x.x') { + exclude group: 'com.adjust.signature', module: 'adjust-android-signature' + } - + implementation 'com.adjust.signature:adjust-android-signature:x.x.x' +} +``` -Androidプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 +または、ベータ版リリースはバージョン`3.24.1`以降からMavenで利用可能です。シグネチャーライブラリをプロジェクトに追加するには、プロジェクトレベルとアプリレベルの`build.gradle`にそれぞれ以下を追加します（利用可能な[最新のバージョン](https://github.com/adjust/adjust_signature_sdk/releases)に変更してください）。 -1. [GitHubからシグネチャーライブラリの内容](https://github.com/adjust/adjust_signature_sdk/releases/latest)を取得します。 +```groovy +repositories { + maven { + url "https://oss.sonatype.org/content/repositories/snapshots/" + } +... +``` + +```groovy +dependencies { + implementation('com.adjust.sdk:adjust-android:5.x.x') { + exclude group: 'com.adjust.signature', module: 'adjust-android-signature' + } + + implementation 'com.adjust.signature:adjust-android-signature:x.x.x-SNAPSHOT' +} +``` + +これで、シグネチャーライブラリがプロジェクトに実装されました。Adjustでデジタル証明書を設定するには、次のセクションの手順に従ってください。 + + + + +1. GitHubから[最新の安定版](https://github.com/adjust/adjust_signature_sdk/releases/latest)または[ベータ版](https://github.com/adjust/adjust_signature_sdk/releases)を取得します。 2. アプリモジュールディレクトリ内に新しい`libs`ディレクトリを作成します。 3. 提供されたAARライブラリを`libs`ディレクトリにコピーします。 @@ -77,7 +117,10 @@ Androidプロジェクトにシグネチャーライブラリを実装するに これで、シグネチャーライブラリがプロジェクトに実装されました。Adjustでデジタル証明書を設定するには、次のセクションの手順に従ってください。 -## Set up your certificates in the Adjust suite {#set-up-your-certificates-in-the-adjust-suite} + + + +## Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} アプリにシグネチャーライブラリを実装すると、Adjust SDKからAdjustに送信される全てのリクエストが署名されます。また、Adjust SDKは、署名証明書のフィンガープリントなどの関連情報をAdjustのサーバーに送信します。 @@ -91,7 +134,7 @@ Androidプロジェクトにシグネチャーライブラリを実装するに -#### From a keystore {#from-a-keystore} +#### キーストアから取得する {#from-a-keystore} 独自のキーストアを使用している場合、またはAndroid Studioが生成したキーストアの場合は、以下の手順に従って証明書フィンガープリントを取得できます。 @@ -105,7 +148,7 @@ Androidプロジェクトにシグネチャーライブラリを実装するに このコマンドを実行すると、キーストアのパスワードが要求されます。これは、キーストアの生成時に定義したパスワードです。 - 最終的な出力結果は、以下のようになります。 + 最終的な出力結果は以下のようになります。 ```text Alias name: Key0 @@ -132,7 +175,7 @@ Androidプロジェクトにシグネチャーライブラリを実装するに 3. SHA\-1フィンガープリントを保存し、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -#### From Google Play Internal App Sharing {#from-google-play-internal-app-sharing} +#### Google Play Internal App Sharingから取得 {#from-google-play-internal-app-sharing} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -145,7 +188,7 @@ Androidプロジェクトにシグネチャーライブラリを実装するに ![Google Play Consoleの証明書ページのスクリーンショット](@images/sig-v3/google-play-internal-sharing.png) -#### From Google Play App Signing {#from-google-play-app-signing} +#### Google Play App Signingから取得 {#from-google-play-app-signing} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用の証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -158,7 +201,7 @@ Androidプロジェクトにシグネチャーライブラリを実装するに ![Google Play ConsoleのApp Signingページのスクリーンショット](@images/sig-v3/google-play-signing.png) -#### From Huawei AppGallery App Signing {#from-huawei-appgallery-app-signing} +#### Huawei AppGallery App Signingから取得 {#from-huawei-appgallery-app-signing} Huawei AppGallery App Signingを使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -188,7 +231,7 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ 3. フィンガープリントを保存して、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -### Add your digital certificate fingerprints to Adjust’s allowlist {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### デジタル証明書フィンガープリントをAdjustの許可リストに追加する {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} @@ -207,7 +250,7 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ これで、フィンガープリントがアプリで許可リストに登録されました。 -## Test your app {#test-your-app} +## アプリをテストする \{\#test\-your\-app\} [Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 @@ -239,3 +282,10 @@ Adjust SDKが **サンドボックス** モードで実行されていること これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/ja/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 + +## シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} + +シグネチャーライブラリは、Adjust SDK v5のアップデートに伴い自動的にアップデートされます。特定のシグネチャーライブラリバージョンが必要な場合は、既存のライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/ja/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 + +- インストールのレポーティングに貢献していない。 +- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 diff --git a/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx index 9148857deb..925ccaf265 100644 --- a/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx @@ -12,6 +12,12 @@ redirects: v5: /ja/sdk/ios/integrations/signature-library --- + + +このページでは、Adjust SDK v4の連携手順について説明します。Adjust SDK v5をご使用の場合は、左側のドロップダウンメニューから適切なタブを選択してください。 + + + AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 ## 事前準備 \{\#before\-you\-begin\} @@ -34,24 +40,52 @@ Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツー - 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 - 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -### シグネチャーライブラリの更新 {#updating-the-signature-library} +## シグネチャーライブラリを実装する \{\#integrate\-the\-signature\-library\} -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。Adjustでアプリのロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 + + -- インストールのレポーティングに貢献していない。 -- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 +シグネチャーライブラリは[GitHub](https://github.com/adjust/adjust_signature_sdk/releases/)でリリースされ、バージョン`3.20.1`以降からCocoapodsに反映されます。シグネチャーライブラリをプロジェクトに追加するには、`Podfile`に以下を追加します（利用可能な[最新のバージョン](https://github.com/adjust/adjust_signature_sdk/releases/latest)に変更してください）。 + +```ruby +pod 'AdjustSignature', '~> x.x.x' +``` + +または、ベータ版リリースはバージョン`3.24.1`以降で利用可能です。シグネチャーライブラリをプロジェクトに追加するには、`Podfile`に以下を追加します（利用可能な[最新のバージョン](https://github.com/adjust/adjust_signature_sdk/releases)に変更してください）。 + +```ruby +pod 'AdjustSignature', 'x.x.x-beta' +``` + +これで、シグネチャーライブラリがプロジェクトに実装されました。 -## シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} + + + +SPMサポートはバージョン`3.20.1`以降で利用可能です。シグネチャーライブラリを追加するには、Xcodeプロジェクトに追加する必要があります。 + +1. **File —> Swift Packages —> Add Package Dependency** を選択します。 +2. 表示されたボックスに、シグネチャーのGitHubのアドレス（[https://github.com/adjust/adjust_signature_sdk](https://github.com/adjust/adjust_signature_sdk)）を入力します。 +3. **Version** フィールドに、使用したいライブラリのバージョンを入力します。最新のパージョンは[リリースページ](https://github.com/adjust/adjust_signature_sdk/releases/latest)からご確認ください。 + +または、ベータ版リリースのSPMサポートはバージョン`3.24.1`以降で利用可能です。シグネチャーライブラリを追加するには、Xcodeプロジェクトに追加する必要があります。 + +1. **File —> Swift Packages —> Add Package Dependency** を選択します。 +2. 表示されたボックスに、シグネチャーのGitHubのアドレス（[https://github.com/adjust/adjust_signature_sdk](https://github.com/adjust/adjust_signature_sdk)）を入力します。 +3. **Branch** フィールドに`release/vx.xx`と入力します。`x.xx`を、[リリースページ](https://github.com/adjust/adjust_signature_sdk/releases)の最新のメジャーバージョンとマイナーバージョンを置き換えます（例：`release/v3.24`）。 -Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 +`main` branchをターゲットとすると、ベータ版を取得する可能性があります。 -iOSプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 +これで、シグネチャーライブラリがプロジェクトに実装されました。 + + + -1. [GitHubから](https://github.com/adjust/adjust_signature_sdk/releases/latest)`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip`アーカイブをダウンロードします。 +1. GitHubから[最新の安定版](https://github.com/adjust/adjust_signature_sdk/releases/latest)またはDynamic XCFrameworkの[ベータ版](https://github.com/adjust/adjust_signature_sdk/releases)を取得します。 2. アーカイブを解凍し、 `AdjustSigSdk.xcframework`をプロジェクトのディレクトリにコピーします。 3. Xcodeの **プロジェクトナビゲーター** でプロジェクトを選択します。 4. 左側のターゲットを選択します。 @@ -70,6 +104,9 @@ iOSプロジェクトにシグネチャーライブラリを実装するには これで、シグネチャーライブラリがプロジェクトに実装されました。 + + + ## アプリをテストする \{\#test\-your\-app\} [Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 @@ -108,3 +145,10 @@ Adjust SDKが **サンドボックス** モードで実行されていること ### Upload symbols failed Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 + +## シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} + +シグネチャーライブラリの更新とは、既存のライブラリを新しいバージョンに置き換え、テストを再度実行することです。Adjustでアプリのロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 + +- インストールのレポーティングに貢献していない。 +- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 diff --git a/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx index f682e0b632..0ff63daec3 100644 --- a/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx @@ -12,13 +12,19 @@ redirects: v4: /ja/sdk/ios/v4/integrations/signature-library --- + + +このページでは、Adjust SDK v5の実装手順について説明します。Adjust SDK v4をご使用の場合は、左側のドロップダウンメニューから適切なタブを選択してください。 + + + AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 ## 事前準備 \{\#before\-you\-begin\} AdjustシグネチャーライブラリをiOSアプリに実装する前に、以下を確認してください。 -- お使いのAdjust SDKバージョンが **4\.35\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 +- お使いのAdjust SDKバージョンが **5\.0\.0以降** であること。この要件は、Adjust SDKが間接的に使用される場合にも適用されます。 - iOSまたはtvOSのバージョン **12以降** に対応していること。 @@ -34,24 +40,56 @@ Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツー - 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 - 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -### シグネチャーライブラリの更新 {#updating-the-signature-library} +## シグネチャーライブラリを実装する \{\#integrate\-the\-signature\-library\} -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。Adjustでアプリのロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 + -- インストールのレポーティングに貢献していない。 -- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 +Adjust SDKには、ほとんどの場合、デフォルトでシグネチャーライブラリが含まれています。Adjust SDKからの指示がある場合、または特定のシグネチャーライブラリバージョンが必要な場合にのみ実行してください。 + + + + +シグネチャーライブラリは[GitHub](https://github.com/adjust/adjust_signature_sdk/releases/)でリリースされ、バージョン`3.20.1`以降からCocoapodsに反映されます。シグネチャーライブラリをプロジェクトに追加するには、`Podfile`に以下を追加します（利用可能な[最新のバージョン](https://github.com/adjust/adjust_signature_sdk/releases/latest)に変更してください）。 + +```ruby +pod 'AdjustSignature', '~> x.x.x' +``` + +または、ベータ版リリースはバージョン`3.24.1`以降で利用可能です。シグネチャーライブラリをプロジェクトに追加するには、`Podfile`に以下を追加します（利用可能な[最新のバージョン](https://github.com/adjust/adjust_signature_sdk/releases)に変更してください）。 + +```ruby +pod 'AdjustSignature', 'x.x.x-beta' +``` -## シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} +これで、シグネチャーライブラリがプロジェクトに実装されました。 + + + + +SPMサポートはバージョン`3.20.1`以降で利用可能です。シグネチャーライブラリを追加するには、Xcodeプロジェクトに追加する必要があります。 + +1. **File —> Swift Packages —> Add Package Dependency** を選択します。 +2. 表示されたボックスに、シグネチャーのGitHubのアドレス（[https://github.com/adjust/adjust_signature_sdk](https://github.com/adjust/adjust_signature_sdk)）を入力します。 +3. **Version** フィールドに、使用したいライブラリのバージョンを入力します。最新のパージョンは[リリースページ](https://github.com/adjust/adjust_signature_sdk/releases/latest)からご確認ください。 + +または、ベータ版リリースのSPMサポートはバージョン`3.24.1`以降で利用可能です。シグネチャーライブラリを追加するには、Xcodeプロジェクトに追加する必要があります。 + +1. **File —> Swift Packages —> Add Package Dependency** を選択します。 +2. 表示されたボックスに、シグネチャーのGitHubのアドレス（[https://github.com/adjust/adjust_signature_sdk](https://github.com/adjust/adjust_signature_sdk)）を入力します。 +3. **Branch** フィールドに`release/vx.xx`と入力します。`x.xx`を、[リリースページ](https://github.com/adjust/adjust_signature_sdk/releases)の最新のメジャーバージョンとマイナーバージョンを置き換えます（例：`release/v3.24`）。 -Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 +`main` branchをターゲットとすると、ベータ版を取得する可能性があります。 -iOSプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 +これで、シグネチャーライブラリがプロジェクトに実装されました。 + + + -1. [GitHubから](https://github.com/adjust/adjust_signature_sdk/releases/latest)`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip`アーカイブをダウンロードします。 +1. GitHubから[最新の安定版](https://github.com/adjust/adjust_signature_sdk/releases/latest)またはDynamic XCFrameworkの[ベータ版](https://github.com/adjust/adjust_signature_sdk/releases)を取得します。 2. アーカイブを解凍し、 `AdjustSigSdk.xcframework`をプロジェクトのディレクトリにコピーします。 3. Xcodeの **プロジェクトナビゲーター** でプロジェクトを選択します。 4. 左側のターゲットを選択します。 @@ -70,6 +108,9 @@ iOSプロジェクトにシグネチャーライブラリを実装するには これで、シグネチャーライブラリがプロジェクトに実装されました。 + + + ## アプリをテストする \{\#test\-your\-app\} [Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 @@ -108,3 +149,10 @@ Adjust SDKが **サンドボックス** モードで実行されていること ### Upload symbols failed Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 + +## シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} + +シグネチャーライブラリは、Adjust SDK v5のアップデートに伴い自動的にアップデートされます。特定のシグネチャーライブラリバージョンが必要な場合は、既存のライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/ja/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 + +- インストールのレポーティングに貢献していない。 +- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 diff --git a/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx index 5f60150da7..e74fac3e28 100644 --- a/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx @@ -12,13 +12,19 @@ redirects: v5: /ja/sdk/unity/integrations/signature-library --- + + +このページでは、Adjust SDK v4の連携手順について説明します。Adjust SDK v5をご使用の場合は、左側のドロップダウンメニューから適切なタブを選択してください。 + + + AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 ## 事前準備 \{\#before\-you\-begin\} -SDK Signatureライブラリは、[16KBのページサイズ](https://developer.android.com/guide/practices/page-sizes)を使用するように設定されており、[バージョン3\.32\.0以降](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)で利用可能です。 +シグネチャーライブラリは、[16KBのページサイズ](https://developer.android.com/guide/practices/page-sizes)を使用するように設定されており、[バージョン3\.32\.0以降](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)で利用可能です。 @@ -41,24 +47,11 @@ Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツー - 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 - 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -### シグネチャーライブラリの更新 {#updating-the-signature-library} - -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/ja/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 - -- インストールのレポーティングに貢献していない。 -- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 - -## シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} - - - -Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 - - +## シグネチャーライブラリを実装する \{\#integrate\-the\-signature\-library\} Unityプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 -1. [GitHubからシグネチャーライブラリの内容](https://github.com/adjust/adjust_signature_sdk/releases/latest)を取得します。 +1. GitHubから[最新の安定版](https://github.com/adjust/adjust_signature_sdk/releases/latest)または[ベータ版](https://github.com/adjust/adjust_signature_sdk/releases)を取得します。 2. Androidアーカイブ（`.aar`）ファイルをUnityプロジェクト内の`Assets/Adjust/Android`ディレクトリに配置します。 3. iOS static framework（`.a`）をUnityプロジェクト内の`Assets/Adjust/iOS`ディレクトリに配置します。 @@ -244,3 +237,10 @@ Xcode 16で構築されたアプリを検証または提出すると、シグネ Unity Editor 2018以降では、 **Unknown CPU Architecture** というエラーメッセージが表示される場合があります。このエラーメッセージは、UnityエディターがiOS static framework（`.a`）をiOS以外のプラットフォームに適用しようとする場合に表示されます。この問題を解決するには、 `AdjustSigSdk.a`ファイルを選択し、 **Import Settings** メニューで **iOS** を除く全てのプラットフォームの選択を解除してください。 ![UnityエディターのAdjustSdk Import Settingsのスクリーンショット](@images/sig-v3/unity-import-settings.png) + +## シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} + +シグネチャーライブラリの更新とは、既存のライブラリを新しいバージョンに置き換え、テストを再度実行することです。Adjustでアプリのロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 + +- インストールのレポーティングに貢献していない。 +- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 diff --git a/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx index 9bc98d92c3..26e16b0052 100644 --- a/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx @@ -12,20 +12,26 @@ redirects: v4: /ja/sdk/unity/v4/integrations/signature-library --- + + +このページでは、Adjust SDK v5の実装手順について説明します。Adjust SDK v4をご使用の場合は、左側のドロップダウンメニューから適切なタブを選択してください。 + + + AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 ## 事前準備 \{\#before\-you\-begin\} -SDK Signatureライブラリは、[16KBのページサイズ](https://developer.android.com/guide/practices/page-sizes)を使用するように設定されており、[バージョン3\.32\.0以降](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)で利用可能です。 +シグネチャーライブラリは、[16KBのページサイズ](https://developer.android.com/guide/practices/page-sizes)を使用するように設定されており、[バージョン3\.32\.0以降](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)で利用可能です。 シグネチャーライブラリをUnityアプリに実装する前に、以下を確認してください。 - 使用中のAndroid APIバージョンが **21以降** であること。 -- お使いのAdjust SDKバージョンが **4\.37\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 +- お使いのAdjust SDKバージョンが **5\.0\.0以降** であること。この要件は、Adjust SDKが間接的に使用される場合にも適用されます。 - Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 @@ -41,24 +47,17 @@ Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツー - 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 - 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -### シグネチャーライブラリの更新 {#updating-the-signature-library} - -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/ja/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 - -- インストールのレポーティングに貢献していない。 -- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 - -## シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} +## シグネチャーライブラリを実装する \{\#integrate\-the\-signature\-library\} -Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 +[External dependency Manager for Unity（EDM4U）](https://github.com/googlesamples/unity-jar-resolver)を使用する場合は、この手順をスキップできます。 Unityプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 -1. [GitHubからシグネチャーライブラリの内容](https://github.com/adjust/adjust_signature_sdk/releases/latest)を取得します。 +1. GitHubから[最新の安定版](https://github.com/adjust/adjust_signature_sdk/releases/latest)または[ベータ版](https://github.com/adjust/adjust_signature_sdk/releases)を取得します。 2. Androidアーカイブ（`.aar`）ファイルをUnityプロジェクト内の`Assets/Adjust/Android`ディレクトリに配置します。 3. iOS static framework（`.a`）をUnityプロジェクト内の`Assets/Adjust/iOS`ディレクトリに配置します。 @@ -244,3 +243,10 @@ Xcode 16で構築されたアプリを検証または提出すると、シグネ Unity Editor 2018以降では、 **Unknown CPU Architecture** というエラーメッセージが表示される場合があります。このエラーメッセージは、UnityエディターがiOS static framework（`.a`）をiOS以外のプラットフォームに適用しようとする場合に表示されます。この問題を解決するには、 `AdjustSigSdk.a`ファイルを選択し、 **Import Settings** メニューで **iOS** を除く全てのプラットフォームの選択を解除してください。 ![UnityエディターのAdjustSdk Import Settingsのスクリーンショット](@images/sig-v3/unity-import-settings.png) + +## シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} + +シグネチャーライブラリは、Adjust SDK v5のアップデートに伴い自動的にアップデートされます。特定のシグネチャーライブラリバージョンが必要な場合は、既存のライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/ja/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 + +- インストールのレポーティングに貢献していない。 +- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 diff --git a/src/content/docs/ko/sdk/android/v4/integrations/signature-library.mdx b/src/content/docs/ko/sdk/android/v4/integrations/signature-library.mdx index 77274d8bcd..8ccea0d523 100644 --- a/src/content/docs/ko/sdk/android/v4/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/android/v4/integrations/signature-library.mdx @@ -12,16 +12,27 @@ redirects: v5: /ko/sdk/android/integrations/signature-library --- + + +본 페이지는 Adjust SDK v4에 대한 연동 단계를 설명합니다. Adjust SDK v5를 사용하는 경우, 왼쪽의 드롭다운 메뉴에서 해당 탭을 선택합니다. + + + Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -## Before you begin {#before-you-begin} +## 시작에 앞서 \{\#before\-you\-begin\} + + + +SDK Signature\(SDK 서명\) 라이브러리는 [버전 3\.32\.0 이상](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)에서 [16KB 페이지 크기](https://developer.android.com/guide/practices/page-sizes)를 사용하도록 구성됩니다. + + 서명 라이브러리를 Android 앱에 연동하려면 다음을 확인하시기 바랍니다. -- 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. -- 사용 중인 Adjust SDK 버전이 **4\.38\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK가 간접적으로 사용되는 경우에도 적용됩니다. -- Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. -- [116KB page size aligned Signature libraries](https://developer.android.com/guide/practices/page-sizes) 에 관심이 있는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일 주시기 바랍니다. +- 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. +- 사용 중인 Adjust SDK 버전이 **4\.38\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. +- Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. @@ -29,31 +40,48 @@ Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +### Signature v1 또는 v2 라이브러리에서 마이그레이션 {#migrating-from-signature-v1-or-v2-library} -이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 서명 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 다음을 수행하시기 바랍니다. +이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 이를 위해 다음을 수행하시기 바랍니다. -- 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. -- 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. +- 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. +- 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -### Updating the Signature Library {#updating-the-signature-library} +## Signature 라이브러리 연동 \{\#integrate\-the\-signature\-library\} -Adjust Signature 라이브러리를 업데이트하려면 기존의 Signature 라이브러리를 새 버전으로 교체하고 테스트를 다시 실행하시기 바랍니다. [인증서가 구성되고 변경되지 않은](https://help.adjust.com/ko/article/sdk-signature#manage-your-certificate-fingerprints) 한 Adjust에서 앱 로직이나 설정을 즉시 변경할 필요는 없습니다. [시크릿 ID가 다음 기준에 부합하는 경우 반드시 비활성화하시기 바랍니다](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids). + + -- 더 이상 설치 리포트에 기여하지 않는 경우. -- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시 +라이브러리는 [GitHub에서](https://github.com/adjust/adjust_signature_sdk/releases/) 릴리스되며, `3.20.1` 버전부터 Maven으로 전달됩니다. 프로젝트에 라이브러리를 추가하려면 다음을 앱 수준 `build.gradle`에 추가합니다\([최신 버전](https://github.com/adjust/adjust_signature_sdk/releases/latest)으로 변경\). -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +```groovy +dependencies { + implementation 'com.adjust.signature:adjust-android-signature:x.x.x' +} +``` - +또는 `3.24.1` 버전 이상의 베타 릴리스를 Maven에서 이용할 수 있습니다. 프로젝트에 Signature 라이브러리를 추가하려면 다음을 프로젝트 수준 및 앱 수준 `build.gradle`에 각각 추가합니다\([최신 버전](https://github.com/adjust/adjust_signature_sdk/releases)으로 변경\). -Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. +```groovy +repositories { + maven { + url "https://oss.sonatype.org/content/repositories/snapshots/" + } +... +``` - +```groovy +dependencies { + implementation 'com.adjust.signature:adjust-android-signature:x.x.x-SNAPSHOT' +} +``` + +이제 끝입니다\! 서명 라이브러리가 프로젝트에 연동되었습니다. 다음 섹션의 단계에 따라 Adjust suite의 디지털 인증서를 설정합니다. -다음 단계에 따라 Android 프로젝트에서 서명 라이브러리를 연동합니다. + + -1. [GitHub에서 서명 라이브러리 콘텐츠](https://github.com/adjust/adjust_signature_sdk/releases/latest)를 불러옵니다. +1. GitHub에서 [최신 Stable 버전](https://github.com/adjust/adjust_signature_sdk/releases/latest) 또는 [베타](https://github.com/adjust/adjust_signature_sdk/releases) 버전을 가져옵니다. 2. 앱 모듈 디렉터리 내에 새 `libs` 디렉터리를 생성합니다. 3. 제공된 AAR 라이브러리를 `libs` 디렉터리에 복사합니다. @@ -75,9 +103,12 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 5. Android Studio 팝업창에서 **Sync Now** 를 선택하여 변경 사항을 동기화합니다. -이제 끝입니다\! Signature 라이브러리가 프로젝트에 연동되었습니다. 다음 섹션의 단계에 따라 Adjust suite의 디지털 인증서를 설정합니다. +이제 끝입니다\! 서명 라이브러리가 프로젝트에 연동되었습니다. 다음 섹션의 단계에 따라 Adjust suite의 디지털 인증서를 설정합니다. -## Set up your certificates in the Adjust suite {#set-up-your-certificates-in-the-adjust-suite} + + + +## Adjust Suite에서 인증서 설정 \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송하는 모든 요청이 서명됩니다. Adjust SDK는 또한 서명 인증서의 핑거프린트를 포함한 관련 정보를 Adjust 서버로 전송합니다. @@ -87,11 +118,11 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 -서명 인증서의 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱으로부터의 트래픽이 스푸핑될 수 있습니다. +서명 인증 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱에서 발생하는 트래픽이 스푸핑될 수 있습니다. -#### From a keystore {#from-a-keystore} +#### Keystore 사용 {#from-a-keystore} 자체 키스토어를 사용하거나 Android Studio에서 키스토어가 생성된 경우 다음 단계에 따라 인증서의 핑거프린트를 가져올 수 있습니다. @@ -132,7 +163,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 3. SHA\-1 핑거프린트를 저장하여 [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)합니다. -#### From Google Play Internal App Sharing {#from-google-play-internal-app-sharing} +#### Google Play Internal App Sharing 사용 {#from-google-play-internal-app-sharing} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -145,7 +176,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 인증서 페이지 스크린샷](@images/sig-v3/google-play-internal-sharing.png) -#### From Google Play App Signing {#from-google-play-app-signing} +#### Google Play App Signing 사용 {#from-google-play-app-signing} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -158,7 +189,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 앱 서명 페이지 스크린샷](@images/sig-v3/google-play-signing.png) -#### From Huawei AppGallery App Signing {#from-huawei-appgallery-app-signing} +#### Huawei AppGallery App Signing 사용 {#from-huawei-appgallery-app-signing} Huawei AppGallery App Signing을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -188,11 +219,11 @@ Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토 3. [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)할 핑거프린트를 저장합니다. -### Add your digital certificate fingerprints to Adjust’s allowlist {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} -Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 된다는 점을 기억해 주십시오. 디버그 버전과 다른 스토어의 버전이 포함될 수 있습니다. +Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 합니다. 디버그 버전과 다른 스토어의 버전이 포함될 수 있습니다. @@ -202,12 +233,12 @@ Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 2. **Protection** 탭을 선택합니다. 3. **의심되는 설치** 섹션의 **편집** 버튼을 선택합니다. 4. **Android 핑거프린팅** 섹션에서 **새 핑거프린트** 를 선택합니다. -5. SHA\-1 핑거프린트를 표시되는 텍스트 상자에 붙여넣기합니다. +5. SHA\-1 핑거프린트를 표시되는 텍스트 상자에 붙여넣기 합니다. 6. **추가** 를 선택합니다. 이제 끝입니다\! 이제 핑거프린트가 앱의 허용 리스트에 추가되었습니다. -## Test your app {#test-your-app} +## 앱 테스트 \{\#test\-your\-app\} [Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. @@ -239,3 +270,10 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. 이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. 이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. + +## Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} + +Signature 라이브러리 업데이트는 기존 라이브러리를 새로운 버전으로 교체하고 테스트를 재실행하는 것으로 구성됩니다. 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화해야 합니다](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids). + +- 더 이상 설치 리포트에 필요하지 않는 경우. +- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. diff --git a/src/content/docs/ko/sdk/android/v5/integrations/signature-library.mdx b/src/content/docs/ko/sdk/android/v5/integrations/signature-library.mdx index 97bf27ad71..319622a0d6 100644 --- a/src/content/docs/ko/sdk/android/v5/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/android/v5/integrations/signature-library.mdx @@ -12,16 +12,27 @@ redirects: v4: /ko/sdk/android/v4/integrations/signature-library --- + + +본 페이지는 Adjust SDK v5의 연동 단계를 설명합니다. Adjust SDK v4를 사용하는 경우, 왼쪽의 드롭다운 메뉴에서 해당 탭을 선택합니다. + + + Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -## Before you begin {#before-you-begin} +## 시작에 앞서 \{\#before\-you\-begin\} + + + +Signature\(서명\) 라이브러리는 [버전 3\.32\.0 이상](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)에서 [16KB 페이지 크기](https://developer.android.com/guide/practices/page-sizes)를 사용하도록 구성됩니다. + + 서명 라이브러리를 Android 앱에 연동하려면 다음을 확인하시기 바랍니다. -- 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. -- 사용 중인 Adjust SDK 버전이 **4\.38\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK가 간접적으로 사용되는 경우에도 적용됩니다. -- Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. -- [116KB page size aligned Signature libraries](https://developer.android.com/guide/practices/page-sizes) 에 관심이 있는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일 주시기 바랍니다. +- 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. +- 사용 중인 Adjust SDK 버전이 **5\.0\.0 이상** 이어야 하며, 이는 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. +- Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. @@ -29,31 +40,60 @@ Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +### Signature v1 또는 v2 라이브러리에서 마이그레이션 {#migrating-from-signature-v1-or-v2-library} -이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 서명 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 다음을 수행하시기 바랍니다. +이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 이를 위해 다음을 수행하시기 바랍니다. -- 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. -- 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. +- 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. +- 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -### Updating the Signature Library {#updating-the-signature-library} +## Signature 라이브러리 연동 \{\#integrate\-the\-signature\-library\} -Adjust Signature 라이브러리를 업데이트하려면 기존의 Signature 라이브러리를 새 버전으로 교체하고 테스트를 다시 실행하시기 바랍니다. [인증서가 구성되고 변경되지 않은](https://help.adjust.com/ko/article/sdk-signature#manage-your-certificate-fingerprints) 한 Adjust에서 앱 로직이나 설정을 즉시 변경할 필요는 없습니다. [시크릿 ID가 다음 기준에 부합하는 경우 반드시 비활성화하시기 바랍니다](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids). + -- 더 이상 설치 리포트에 기여하지 않는 경우. -- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시 +Adjust SDK는 대부분의 경우 Signature 라이브러리를 기본값으로 포함합니다. Adjust SDK의 프롬프트가 있거나 특정 Signature 라이브러리 버전이 필요한 경우에만 계속 진행하시기 바랍니다. -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} + + - +Signature 라이브러리는 [GitHub에서](https://github.com/adjust/adjust_signature_sdk/releases/) 릴리스되며, `3.20.1` 버전부터 Maven으로 전달됩니다. 프로젝트에 라이브러리를 추가하려면 다음을 앱 수준 `build.gradle`에 추가합니다\(최신 버전으로 변경\). -Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. +```groovy +dependencies { + implementation('com.adjust.sdk:adjust-android:5.x.x') { + exclude group: 'com.adjust.signature', module: 'adjust-android-signature' + } - + implementation 'com.adjust.signature:adjust-android-signature:x.x.x' +} +``` + +또는 `3.24.1` 버전 이상의 베타 릴리스를 Maven에서 이용할 수 있습니다. 프로젝트에 Signature 라이브러리를 추가하려면 다음을 프로젝트 수준 및 앱 수준의 `build.gradle`에 각각 추가합니다\([최신 버전](https://github.com/adjust/adjust_signature_sdk/releases)으로 변경\). + +```groovy +repositories { + maven { + url "https://oss.sonatype.org/content/repositories/snapshots/" + } +... +``` + +```groovy +dependencies { + implementation('com.adjust.sdk:adjust-android:5.x.x') { + exclude group: 'com.adjust.signature', module: 'adjust-android-signature' + } -다음 단계에 따라 Android 프로젝트에서 서명 라이브러리를 연동합니다. + implementation 'com.adjust.signature:adjust-android-signature:x.x.x-SNAPSHOT' +} +``` -1. [GitHub에서 서명 라이브러리 콘텐츠](https://github.com/adjust/adjust_signature_sdk/releases/latest)를 불러옵니다. +이제 끝입니다\! 서명 라이브러리가 프로젝트에 연동되었습니다. 다음 섹션의 단계에 따라 Adjust suite의 디지털 인증서를 설정합니다. + + + + +1. GitHub에서 [최신 Stable 버전](https://github.com/adjust/adjust_signature_sdk/releases/latest) 또는 [베타](https://github.com/adjust/adjust_signature_sdk/releases) 버전을 가져옵니다. 2. 앱 모듈 디렉터리 내에 새 `libs` 디렉터리를 생성합니다. 3. 제공된 AAR 라이브러리를 `libs` 디렉터리에 복사합니다. @@ -75,9 +115,12 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 5. Android Studio 팝업창에서 **Sync Now** 를 선택하여 변경 사항을 동기화합니다. -이제 끝입니다\! Signature 라이브러리가 프로젝트에 연동되었습니다. 다음 섹션의 단계에 따라 Adjust suite의 디지털 인증서를 설정합니다. +이제 끝입니다\! 서명 라이브러리가 프로젝트에 연동되었습니다. 다음 섹션의 단계에 따라 Adjust suite의 디지털 인증서를 설정합니다. + + + -## Set up your certificates in the Adjust suite {#set-up-your-certificates-in-the-adjust-suite} +## Adjust Suite에서 인증서 설정 \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송하는 모든 요청이 서명됩니다. Adjust SDK는 또한 서명 인증서의 핑거프린트를 포함한 관련 정보를 Adjust 서버로 전송합니다. @@ -87,11 +130,11 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 -서명 인증서의 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱으로부터의 트래픽이 스푸핑될 수 있습니다. +서명 인증 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱에서 발생하는 트래픽이 스푸핑될 수 있습니다. -#### From a keystore {#from-a-keystore} +#### Keystore 사용 {#from-a-keystore} 자체 키스토어를 사용하거나 Android Studio에서 키스토어가 생성된 경우 다음 단계에 따라 인증서의 핑거프린트를 가져올 수 있습니다. @@ -132,7 +175,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 3. SHA\-1 핑거프린트를 저장하여 [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)합니다. -#### From Google Play Internal App Sharing {#from-google-play-internal-app-sharing} +#### Google Play Internal App Sharing 사용 {#from-google-play-internal-app-sharing} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -145,7 +188,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 인증서 페이지 스크린샷](@images/sig-v3/google-play-internal-sharing.png) -#### From Google Play App Signing {#from-google-play-app-signing} +#### Google Play App Signing 사용 {#from-google-play-app-signing} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -158,7 +201,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 앱 서명 페이지 스크린샷](@images/sig-v3/google-play-signing.png) -#### From Huawei AppGallery App Signing {#from-huawei-appgallery-app-signing} +#### Huawei AppGallery App Signing 사용 {#from-huawei-appgallery-app-signing} Huawei AppGallery App Signing을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -188,11 +231,11 @@ Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토 3. [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)할 핑거프린트를 저장합니다. -### Add your digital certificate fingerprints to Adjust’s allowlist {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} -Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 된다는 점을 기억해 주십시오. 디버그 버전과 다른 스토어의 버전이 포함될 수 있습니다. +Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 합니다. 디버그 버전과 다른 스토어의 버전이 포함될 수 있습니다. @@ -202,12 +245,12 @@ Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 2. **Protection** 탭을 선택합니다. 3. **의심되는 설치** 섹션의 **편집** 버튼을 선택합니다. 4. **Android 핑거프린팅** 섹션에서 **새 핑거프린트** 를 선택합니다. -5. SHA\-1 핑거프린트를 표시되는 텍스트 상자에 붙여넣기합니다. +5. SHA\-1 핑거프린트를 표시되는 텍스트 상자에 붙여넣기 합니다. 6. **추가** 를 선택합니다. 이제 끝입니다\! 이제 핑거프린트가 앱의 허용 리스트에 추가되었습니다. -## Test your app {#test-your-app} +## 앱 테스트 \{\#test\-your\-app\} [Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. @@ -239,3 +282,10 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. 이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. 이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. + +## Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} + +Signature 라이브러리는 Adjust SDK v5 업데이트와 함께 자동으로 업데이트됩니다. 특정 Signature 라이브러리 버전이 필요한 경우 기존 라이브러리를 새 버전으로 교체하고, 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/ko/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids)해야 합니다. + +- 더 이상 설치 리포트에 필요하지 않는 경우. +- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. diff --git a/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx index fd173ebc77..e248795161 100644 --- a/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx @@ -12,6 +12,12 @@ redirects: v5: /ko/sdk/ios/integrations/signature-library --- + + +본 페이지는 Adjust SDK v4에 대한 연동 단계를 설명합니다. Adjust SDK v5를 사용하는 경우, 왼쪽의 드롭다운 메뉴에서 해당 탭을 선택합니다. + + + Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. ## 시작에 앞서 \{\#before\-you\-begin\} @@ -34,24 +40,52 @@ Adjust Signature 라이브러리를 iOS 앱에 연동하려면 다음을 확인 - 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. - 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -### Signature 라이브러리 업데이트 {#updating-the-signature-library} +## Signature 라이브러리 연동 \{\#integrate\-the\-signature\-library\} -Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화해야 합니다](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids). + + -- 더 이상 설치 리포트에 필요하지 않는 경우. -- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. +Signature 라이브러리는 [GitHub에서](https://github.com/adjust/adjust_signature_sdk/releases/) 릴리스되며 `3.20.1` 버전부터 Cocoapods에 전달됩니다. 프로젝트에 Signature 라이브러리를 추가하려면 다음을 `Podfile`에 추가합니다\([최신 버전](https://github.com/adjust/adjust_signature_sdk/releases/latest)으로 변경\). + +```ruby +pod 'AdjustSignature', '~> x.x.x' +``` + +베타 릴리스는 `3.24.1` 버전부터 이용 가능합니다. 프로젝트에 Signature 라이브러리를 추가하려면 다음을 `Podfile`에 추가합니다\([최신 버전](https://github.com/adjust/adjust_signature_sdk/releases)으로 변경\). + +```ruby +pod 'AdjustSignature', 'x.x.x-beta' +``` + +이제 끝입니다\! Signature 라이브러리가 프로젝트에 연동되었습니다. -## Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} + + + +SPM 지원은 `3.20.1` 버전부터 이용 가능합니다. Signature 라이브러리를 추가하려면 Xcode 프로젝트에 추가해야 합니다. + +1. **File \-\-> Swift Packages \-\-> Add Package Dependency** 를 선택합니다. +2. 창이 뜨면 Signature의 GitHub 주소[\(https://github.com/adjust/adjust_signature_sdk\)를 입력합니다.](https://github.com/adjust/adjust_signature_sdk) +3. 사용하고자 하는 라이브러리의 버전을 **Version** 필드에 입력합니다. 최신 버전은 [릴리스 페이지](https://github.com/adjust/adjust_signature_sdk/releases/latest)에서 확인하실 수 있습니다. + +`3.24.1` 버전 이상의 베타 릴리스의 경우, SPM 지원이 제공됩니다. Signature 라이브러리를 추가하려면 Xcode 프로젝트에 추가해야 합니다. + +1. **File \-\-> Swift Packages \-\-> Add Package Dependency** 를 선택합니다. +2. 창이 뜨면 Signature의 GitHub 주소[\(https://github.com/adjust/adjust_signature_sdk\)를 입력합니다.](https://github.com/adjust/adjust_signature_sdk) +3. **Branch** 필드에 `release/vx.xx`를 입력합니다. `x.xx`를 [릴리스 페이지의](https://github.com/adjust/adjust_signature_sdk/releases) 최신 메이저 및 마이너 버전\(예: `release/v3.24`\)으로 바꿉니다. -Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. +`main` branch를 타겟팅하면 베타 버전을 가져올 수 있습니다. -다음 단계에 따라 iOS 프로젝트에서 서명 라이브러리를 연동하십시오. +이제 끝입니다\! Signature 라이브러리가 프로젝트에 연동되었습니다. + + + -1. [GitHub에서`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` 아카이브](https://github.com/adjust/adjust_signature_sdk/releases/latest)를 다운로드합니다. +1. GitHub에서 [최신 Stable 버전](https://github.com/adjust/adjust_signature_sdk/releases/latest) 또는 [베타](https://github.com/adjust/adjust_signature_sdk/releases) Dynamic XCFramework 버전을 가져옵니다. 2. 아카이브를 압축 해제하고 `AdjustSigSdk.xcframework`를 프로젝트의 디렉터리에 복사합니다. 3. Xcode의 **Project Navigator** 에서 프로젝트를 선택합니다. 4. 왼쪽에서 타겟을 선택합니다. @@ -70,6 +104,9 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 이제 끝입니다\! Signature 라이브러리가 프로젝트에 연동되었습니다. + + + ## 앱 테스트 \{\#test\-your\-app\} [Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. @@ -108,3 +145,10 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. ### 심볼 업로드 실패 Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. + +## Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} + +Signature 라이브러리 업데이트는 기존 라이브러리를 새로운 버전으로 교체하고, 테스트를 재실행하는 것으로 구성됩니다. 앱 로직이나 Adjust 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화해야 합니다](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids). + +- 더 이상 설치 리포트에 필요하지 않는 경우. +- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. diff --git a/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx index f6f893d907..4344eda878 100644 --- a/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx @@ -12,13 +12,19 @@ redirects: v4: /ko/sdk/ios/v4/integrations/signature-library --- + + +본 페이지는 Adjust SDK v5의 연동 단계를 설명합니다. Adjust SDK v4를 사용하는 경우, 왼쪽의 드롭다운 메뉴에서 해당 탭을 선택합니다. + + + Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. ## 시작에 앞서 \{\#before\-you\-begin\} Adjust Signature 라이브러리를 iOS 앱에 연동하려면 다음을 확인하시기 바랍니다. -- 사용 중인 Adjust SDK 버전이 **4\.35\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. +- 사용 중인 Adjust SDK 버전이 **5\.0\.0 이상** 이어야 하며, 이는 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. - iOS 또는 tvOS 버전 **12 이상** 이 지원됩니다. @@ -34,24 +40,56 @@ Adjust Signature 라이브러리를 iOS 앱에 연동하려면 다음을 확인 - 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. - 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -### Signature 라이브러리 업데이트 {#updating-the-signature-library} +## Signature 라이브러리 연동 \{\#integrate\-the\-signature\-library\} -Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화해야 합니다](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids). + -- 더 이상 설치 리포트에 필요하지 않는 경우. -- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. +Adjust SDK는 대부분의 경우 Signature 라이브러리를 기본값으로 포함합니다. Adjust SDK의 프롬프트가 있거나 특정 Signature 라이브러리 버전이 필요한 경우에만 계속 진행하시기 바랍니다. + + + + +Signature 라이브러리는 [GitHub에서](https://github.com/adjust/adjust_signature_sdk/releases/) 릴리스되며, `3.20.1` 버전부터 Cocoapods에 전달됩니다. 프로젝트에 Signature 라이브러리를 추가하려면 다음을 `Podfile`에 추가합니다\([최신 버전](https://github.com/adjust/adjust_signature_sdk/releases/latest)으로 변경\). + +```ruby +pod 'AdjustSignature', '~> x.x.x' +``` + +베타 릴리스는 `3.24.1` 버전부터 이용 가능합니다. 프로젝트에 Signature 라이브러리를 추가하려면 다음을 `Podfile`에 추가합니다\([최신 버전](https://github.com/adjust/adjust_signature_sdk/releases)으로 변경\). + +```ruby +pod 'AdjustSignature', 'x.x.x-beta' +``` -## Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} +이제 끝입니다\! Signature 라이브러리가 프로젝트에 연동되었습니다. + + + + +SPM 지원은 `3.20.1` 버전부터 이용 가능합니다. Signature 라이브러리를 추가하려면 Xcode 프로젝트에 추가해야 합니다. + +1. **File \-\-> Swift Packages \-\-> Add Package Dependency** 를 선택합니다. +2. 창이 뜨면 서명의 GitHub 주소[\(https://github.com/adjust/adjust_signature_sdk\)를 입력합니다.](https://github.com/adjust/adjust_signature_sdk) +3. 사용하고자 하는 라이브러리의 버전을 **Version** 필드에 입력합니다. 최신 버전은 [릴리스 페이지](https://github.com/adjust/adjust_signature_sdk/releases/latest)에서 확인하실 수 있습니다. + +`3.24.1` 버전 이상의 베타 릴리스의 경우, SPM 지원이 제공됩니다. Signature 라이브러리를 추가하려면 Xcode 프로젝트에 추가해야 합니다. + +1. **File \-\-> Swift Packages \-\-> Add Package Dependency** 를 선택합니다. +2. 창이 뜨면 서명의 GitHub 주소[\(https://github.com/adjust/adjust_signature_sdk\)를 입력합니다.](https://github.com/adjust/adjust_signature_sdk) +3. **Branch** 필드에 `release/vx.xx`를 입력합니다. `x.xx`를 [릴리스 페이지의](https://github.com/adjust/adjust_signature_sdk/releases) 최신 메이저 및 마이너 버전\(예: `release/v3.24`\)으로 바꿉니다. -Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. +`main` branch를 타겟팅하면 베타 버전을 가져올 수 있습니다. -다음 단계에 따라 iOS 프로젝트에서 서명 라이브러리를 연동하십시오. +이제 끝입니다\! Signature 라이브러리가 프로젝트에 연동되었습니다. + + + -1. [GitHub에서`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` 아카이브](https://github.com/adjust/adjust_signature_sdk/releases/latest)를 다운로드합니다. +1. GitHub에서 [최신 Stable 버전](https://github.com/adjust/adjust_signature_sdk/releases/latest) 또는 [베타](https://github.com/adjust/adjust_signature_sdk/releases) Dynamic XCFramework 버전을 가져옵니다. 2. 아카이브를 압축 해제하고 `AdjustSigSdk.xcframework`를 프로젝트의 디렉터리에 복사합니다. 3. Xcode의 **Project Navigator** 에서 프로젝트를 선택합니다. 4. 왼쪽에서 타겟을 선택합니다. @@ -70,6 +108,9 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 이제 끝입니다\! Signature 라이브러리가 프로젝트에 연동되었습니다. + + + ## 앱 테스트 \{\#test\-your\-app\} [Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. @@ -108,3 +149,10 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. ### 심볼 업로드 실패 Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. + +## Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} + +Signature 라이브러리는 Adjust SDK v5 업데이트와 함께 자동으로 업데이트됩니다. 특정 라이브러리 버전이 필요한 경우 기존 라이브러리를 새 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/ko/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids)해야 합니다. + +- 더 이상 설치 리포트에 필요하지 않는 경우. +- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. diff --git a/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx index c90e292341..7fac591ac9 100644 --- a/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx @@ -12,6 +12,12 @@ redirects: v5: /ko/sdk/unity/integrations/signature-library --- + + +본 페이지는 Adjust SDK v4에 대한 연동 단계를 설명합니다. Adjust SDK v5를 사용하는 경우, 왼쪽의 드롭다운 메뉴에서 해당 탭을 선택합니다. + + + Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. ## 시작에 앞서 \{\#before\-you\-begin\} @@ -41,24 +47,11 @@ SDK Signature\(SDK 서명\) 라이브러리는 [버전 3\.32\.0 이상](https:// - 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. - 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -### Signature 라이브러리 업데이트 {#updating-the-signature-library} - -Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/ko/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids)해야 합니다. - -- 더 이상 설치 리포트에 필요하지 않는 경우. -- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. - -## Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} - - - -Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. - - +## Signature 라이브러리 연동 \{\#integrate\-the\-signature\-library\} 다음 단계에 따라 Unity 프로젝트에서 서명 라이브러리를 연동합니다. -1. [GitHub에서 서명 라이브러리 콘텐츠](https://github.com/adjust/adjust_signature_sdk/releases/latest)를 불러옵니다. +1. GitHub에서 [최신 Stable 버전](https://github.com/adjust/adjust_signature_sdk/releases/latest) 또는 [베타](https://github.com/adjust/adjust_signature_sdk/releases) 버전을 가져옵니다. 2. Android 아카이브\(`.aar`\) 파일을 통합 프로젝트의 `Assets/Adjust/Android` 디렉터리에 배치합니다. 3. iOS 정적 프레임워크\(`.a`\)를 통합 프로젝트의 `Assets/Adjust/iOS` 디렉터리에 배치합니다. @@ -244,3 +237,10 @@ Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이 Unity Editor 2018 이상 버전에서 **Unknown CPU Architecture** 가 포함된 오류 메시지가 표시될 수 있습니다. 이 오류 메시지는 Unity Editor가 iOS 정적 프레임워크\(`.a`\)를 iOS 외 플랫폼에 적용하려고 시도할 때 나타납니다. 이 문제를 해결하려면 `AdjustSigSdk.a` 파일을 선택한 다음 **Import Settings** 메뉴에서 **iOS** 를 제외한 모든 플랫폼의 선택을 해제합니다. ![Unity Editor의 AdjustSdk Import Settings 스크린샷](@images/sig-v3/unity-import-settings.png) + +## Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} + +Signature 라이브러리 업데이트는 기존 라이브러리를 새로운 버전으로 교체하고 테스트를 재실행하는 것으로 구성됩니다. 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화해야 합니다](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids). + +- 더 이상 설치 리포트에 필요하지 않는 경우. +- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. diff --git a/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx index eb9ae95b7f..1d3e0cb544 100644 --- a/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx @@ -12,20 +12,26 @@ redirects: v4: /ko/sdk/unity/v4/integrations/signature-library --- + + +본 페이지는 Adjust SDK v5의 연동 단계를 설명합니다. Adjust SDK v4를 사용하는 경우, 왼쪽의 드롭다운 메뉴에서 해당 탭을 선택하시기 바랍니다. + + + Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. ## 시작에 앞서 \{\#before\-you\-begin\} -SDK Signature\(SDK 서명\) 라이브러리는 [버전 3\.32\.0 이상](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)에서 [16KB 페이지 크기](https://developer.android.com/guide/practices/page-sizes)를 사용하도록 구성됩니다. +Signature\(서명\) 라이브러리는 [버전 3\.32\.0 이상](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)에서 [16KB 페이지 크기](https://developer.android.com/guide/practices/page-sizes)를 사용하도록 구성됩니다. 서명 라이브러리를 Unity 앱에 연동하려면 다음을 확인하시기 바랍니다. - 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. -- 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. +- 사용 중인 Adjust SDK 버전이 **5\.0\.0 이상** 이어야 하며, 이는 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. - Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. @@ -41,24 +47,17 @@ SDK Signature\(SDK 서명\) 라이브러리는 [버전 3\.32\.0 이상](https:// - 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. - 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -### Signature 라이브러리 업데이트 {#updating-the-signature-library} - -Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/ko/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids)해야 합니다. - -- 더 이상 설치 리포트에 필요하지 않는 경우. -- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. - -## Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} +## Signature 라이브러리 연동 \{\#integrate\-the\-signature\-library\} -Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. +[EDM4U\(External Dependency Manager for Unity\)](https://github.com/googlesamples/unity-jar-resolver)를 사용하는 경우 이 단계를 건너뛸 수 있습니다. 다음 단계에 따라 Unity 프로젝트에서 서명 라이브러리를 연동합니다. -1. [GitHub에서 서명 라이브러리 콘텐츠](https://github.com/adjust/adjust_signature_sdk/releases/latest)를 불러옵니다. +1. GitHub에서 [최신 Stable](https://github.com/adjust/adjust_signature_sdk/releases/latest) 또는 [베타](https://github.com/adjust/adjust_signature_sdk/releases) 버전을 가져옵니다. 2. Android 아카이브\(`.aar`\) 파일을 통합 프로젝트의 `Assets/Adjust/Android` 디렉터리에 배치합니다. 3. iOS 정적 프레임워크\(`.a`\)를 통합 프로젝트의 `Assets/Adjust/iOS` 디렉터리에 배치합니다. @@ -244,3 +243,10 @@ Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이 Unity Editor 2018 이상 버전에서 **Unknown CPU Architecture** 가 포함된 오류 메시지가 표시될 수 있습니다. 이 오류 메시지는 Unity Editor가 iOS 정적 프레임워크\(`.a`\)를 iOS 외 플랫폼에 적용하려고 시도할 때 나타납니다. 이 문제를 해결하려면 `AdjustSigSdk.a` 파일을 선택한 다음 **Import Settings** 메뉴에서 **iOS** 를 제외한 모든 플랫폼의 선택을 해제합니다. ![Unity Editor의 AdjustSdk Import Settings 스크린샷](@images/sig-v3/unity-import-settings.png) + +## Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} + +Signature 라이브러리는 Adjust SDK v5 업데이트와 함께 자동으로 업데이트됩니다. 특정 Signature 라이브러리 버전이 필요한 경우 기존 라이브러리를 새 버전으로 교체하고, 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/ko/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids)해야 합니다. + +- 더 이상 설치 리포트에 필요하지 않는 경우. +- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. diff --git a/src/content/docs/zh/sdk/android/v4/integrations/signature-library.mdx b/src/content/docs/zh/sdk/android/v4/integrations/signature-library.mdx index 118dfccc38..81fa5bf882 100644 --- a/src/content/docs/zh/sdk/android/v4/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/android/v4/integrations/signature-library.mdx @@ -12,16 +12,27 @@ redirects: v5: /zh/sdk/android/integrations/signature-library --- + + +本页面将介绍 Adjust SDK v4 的集成步骤。如果您使用的是 Adjust SDK v4，请打开左侧下拉菜单，选择对应的选项卡。 + + + Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -## Before you begin {#before-you-begin} +## 操作前须知 \{\#before\-you\-begin\} + + + +在 [3\.32\.0 或更高版本](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)中，签名库被配置为使用 [16KB 的页面大小](https://developer.android.com/guide/practices/page-sizes)。 + + 要将签名库集成到您的安卓应用，请确保满足下列条件： -- 正在使用的安卓API 为 **21 或更高版本** 。 -- 正在使用的 Adjust SDK 为 **4\.38\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 -- 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 -- 如需[16KB 页面尺寸对齐的签名库](https://developer.android.com/guide/practices/page-sizes)，请联系您的 Adjust 代表或发送邮件至 [support@adjust.com](mailto:support@adjust.com)。 +- 正在使用的安卓API 为 **21 或更高版本** 。 +- 正在使用的 Adjust SDK 为 **4\.38\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 +- 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 @@ -29,31 +40,48 @@ Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说， -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +### 从 Signature V1 或 V2 库过渡{#migrating-from-signature-v1-or-v2-library} 如果您之前使用的是 Signature v1 或 Signature v2，请先移除旧版本，然后再集成签名库。 为此请进行下列操作： -- 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 -- 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 +- 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 +- 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -### Updating the Signature Library {#updating-the-signature-library} +## 集成签名库 \{\#integrate\-the\-signature\-library\} -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/zh/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： + + -- 应用密钥已不再适用于安装报告。 -- 您已经在所有应用平台和商店中全面发布了应用的新版本。 +签名库已在[GitHub](https://github.com/adjust/adjust_signature_sdk/releases/) 上发布，并从版本 `3.20.1` 起传输至 Maven。要向您的项目添加签名库，请将以下行附加到您的 `build.gradle` 中 \(请更改为[最新可用](https://github.com/adjust/adjust_signature_sdk/releases/latest)版本 \)： -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +```groovy +dependencies { + implementation 'com.adjust.signature:adjust-android-signature:x.x.x' +} +``` - +`3.24.1` 及更高版本也在 Maven 上提供 Beta 版发布。要向您的项目添加签名库，请将以下行分别附加到项目层级和应用层级的 `build.gradle` 中 \(请更改为[最新可用](https://github.com/adjust/adjust_signature_sdk/releases)版本 \)： -Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 +```groovy +repositories { + maven { + url "https://oss.sonatype.org/content/repositories/snapshots/" + } +... +``` - +```groovy +dependencies { + implementation 'com.adjust.signature:adjust-android-signature:x.x.x-SNAPSHOT' +} +``` + +一切就绪！签名库现已集成到您的项目中。请按照下一节说明的步骤操作，在 Adjust suite 中配置您的数字证书。 -请按照下列步骤操作，将签名库集成入您的安卓项目中。 + + -1. [从 GitHub 调取](https://github.com/adjust/adjust_signature_sdk/releases/latest)签名库内容。 +1. 从 GitHub[获取最新的稳定版](https://github.com/adjust/adjust_signature_sdk/releases/latest)或[Beta](https://github.com/adjust/adjust_signature_sdk/releases) 版。 2. 在您的应用模块目录中创建新的 `libs` 目录。 3. 将收到的 AAR 库复制到 `libs` 目录。 @@ -77,7 +105,10 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。请按照下一节说明的步骤操作，在 Adjust suite 中配置您的数字证书。 -## Set up your certificates in the Adjust suite {#set-up-your-certificates-in-the-adjust-suite} + + + +## 在 Adjust 套件中设置证书\{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} 将签名库集成到应用中后，Adjust SDK 向 Adjust 发送的所有请求都会带有签名。Adjust SDK 还会向 Adjust 服务器发送相关信息，包括您的签名证书指纹。 @@ -91,7 +122,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 -#### From a keystore {#from-a-keystore} +#### 从密钥库获取证书指纹{#from-a-keystore} 如果您使用了自己的密钥库，或 Android Studio 为您生成了密钥库，则可以按下列步骤操作，提取证书指纹。 @@ -132,7 +163,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存 SHA\-1 指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -#### From Google Play Internal App Sharing {#from-google-play-internal-app-sharing} +#### 从 Google 内部应用分享获取证书指纹{#from-google-play-internal-app-sharing} 如果您使用的是 [Google Play 内部应用分享](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)，则需要将您所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -145,7 +176,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 ![A screenshot of the certficate page in Google Play Console](@images/sig-v3/google-play-internal-sharing.png) -#### From Google Play App Signing {#from-google-play-app-signing} +#### 从 Google Play 应用签名获取证书指纹{#from-google-play-app-signing} 如果您使用的是 [Google Play 应用签名](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -158,7 +189,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 ![A screenshot of the App signing page in the Google Play Console](@images/sig-v3/google-play-signing.png) -#### From Huawei AppGallery App Signing {#from-huawei-appgallery-app-signing} +#### 从 Huawei AppGallery 应用签名获取证书指纹{#from-huawei-appgallery-app-signing} 如果您使用的是 Huawei AppGallery 应用签名，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -188,7 +219,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -### Add your digital certificate fingerprints to Adjust’s allowlist {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### 将您的数字证书指纹加入 Adjust 许可名单{#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} @@ -207,7 +238,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！您的指纹现已加入应用许可名单。 -## Test your app {#test-your-app} +## 测试应用\{\#test\-your\-app\} 您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 @@ -239,3 +270,10 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 如果这些字段没有缺失，且包含正确的信息，就说明签名库已经成功集成。如果字段中出现了不同的值，请再次检查集成步骤，或发送邮件到 [support@adjust.com](mailto:support@adjust.com) 获取支持。 一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/zh/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 + +## 更新签名库\{\#updating\-the\-signature\-library\} + +要更新签名库，请用新版本替换现有的签名库，然后重新运行测试。您无需立即在 Adjust 中对应用逻辑或设置进行变更。[如果密钥 ID 满足以下条件，请务必将其停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： + +- 应用密钥已不再适用于安装报告。 +- 您已经在所有应用平台和商店中全面发布了应用的新版本。 diff --git a/src/content/docs/zh/sdk/android/v5/integrations/signature-library.mdx b/src/content/docs/zh/sdk/android/v5/integrations/signature-library.mdx index b9660d2cb3..ebe53f6f8a 100644 --- a/src/content/docs/zh/sdk/android/v5/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/android/v5/integrations/signature-library.mdx @@ -12,16 +12,27 @@ redirects: v4: /zh/sdk/android/v4/integrations/signature-library --- + + +本页面将介绍 Adjust SDK v5 的集成步骤。如果您使用的是 Adjust SDK v4，请打开左侧下拉菜单，选择对应的选项卡。 + + + Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -## Before you begin {#before-you-begin} +## 操作前须知 \{\#before\-you\-begin\} + + + +在 [3\.32\.0 或更高版本](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)中，签名库被配置为使用 [16KB 的页面大小](https://developer.android.com/guide/practices/page-sizes)。 + + 要将签名库集成到您的安卓应用，请确保满足下列条件： -- 正在使用的安卓API 为 **21 或更高版本** 。 -- 正在使用的 Adjust SDK 为 **4\.38\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 -- 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 -- 如需[16KB 页面尺寸对齐的签名库](https://developer.android.com/guide/practices/page-sizes)，请联系您的 Adjust 代表或发送邮件至 [support@adjust.com](mailto:support@adjust.com)。 +- 正在使用的安卓API 为 **21 或更高版本** 。 +- 正在使用的 Adjust SDK 为 **5\.0\.0 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 +- 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 @@ -29,31 +40,60 @@ Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说， -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +### 从 Signature V1 或 V2 库过渡{#migrating-from-signature-v1-or-v2-library} 如果您之前使用的是 Signature v1 或 Signature v2，请先移除旧版本，然后再集成签名库。 为此请进行下列操作： -- 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 -- 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 +- 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 +- 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -### Updating the Signature Library {#updating-the-signature-library} +## 集成签名库 \{\#integrate\-the\-signature\-library\} -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/zh/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： + -- 应用密钥已不再适用于安装报告。 -- 您已经在所有应用平台和商店中全面发布了应用的新版本。 +在大多数情况下，SDK 签名库默认包含在 SDK v5 中。您应当仅在收到 SDK 提示，或需要特定 SDK 签名库版本时，才进行单独集成。 -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} + + - +签名库已在[GitHub](https://github.com/adjust/adjust_signature_sdk/releases/) 上发布，并从版本 `3.20.1` 起传输至 Maven。要向您的项目添加签名库，请将以下行附加到您的 `build.gradle` 中 \(请更改为[最新可用](https://github.com/adjust/adjust_signature_sdk/releases/latest)版本 \)： -Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 +```groovy +dependencies { + implementation('com.adjust.sdk:adjust-android:5.x.x') { + exclude group: 'com.adjust.signature', module: 'adjust-android-signature' + } - + implementation 'com.adjust.signature:adjust-android-signature:x.x.x' +} +``` -请按照下列步骤操作，将签名库集成入您的安卓项目中。 +`3.24.1` 及更高版本也在 Maven 上提供 Beta 版发布。要向您的项目添加签名库，请将以下行分别附加到项目层级和应用层级的 `build.gradle` 中 \(请更改为[最新可用](https://github.com/adjust/adjust_signature_sdk/releases)版本 \)： -1. [从 GitHub 调取](https://github.com/adjust/adjust_signature_sdk/releases/latest)签名库内容。 +```groovy +repositories { + maven { + url "https://oss.sonatype.org/content/repositories/snapshots/" + } +... +``` + +```groovy +dependencies { + implementation('com.adjust.sdk:adjust-android:5.x.x') { + exclude group: 'com.adjust.signature', module: 'adjust-android-signature' + } + + implementation 'com.adjust.signature:adjust-android-signature:x.x.x-SNAPSHOT' +} +``` + +一切就绪！签名库现已集成到您的项目中。请按照下一节说明的步骤操作，在 Adjust suite 中配置您的数字证书。 + + + + +1. 从 GitHub[获取最新的稳定版](https://github.com/adjust/adjust_signature_sdk/releases/latest)或[Beta](https://github.com/adjust/adjust_signature_sdk/releases) 版。 2. 在您的应用模块目录中创建新的 `libs` 目录。 3. 将收到的 AAR 库复制到 `libs` 目录。 @@ -77,7 +117,10 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。请按照下一节说明的步骤操作，在 Adjust suite 中配置您的数字证书。 -## Set up your certificates in the Adjust suite {#set-up-your-certificates-in-the-adjust-suite} + + + +## 在 Adjust 套件中设置证书\{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} 将签名库集成到应用中后，Adjust SDK 向 Adjust 发送的所有请求都会带有签名。Adjust SDK 还会向 Adjust 服务器发送相关信息，包括您的签名证书指纹。 @@ -91,7 +134,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 -#### From a keystore {#from-a-keystore} +#### 从密钥库获取证书指纹{#from-a-keystore} 如果您使用了自己的密钥库，或 Android Studio 为您生成了密钥库，则可以按下列步骤操作，提取证书指纹。 @@ -132,7 +175,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存 SHA\-1 指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -#### From Google Play Internal App Sharing {#from-google-play-internal-app-sharing} +#### 从 Google 内部应用分享获取证书指纹{#from-google-play-internal-app-sharing} 如果您使用的是 [Google Play 内部应用分享](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)，则需要将您所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -145,7 +188,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 ![A screenshot of the certficate page in Google Play Console](@images/sig-v3/google-play-internal-sharing.png) -#### From Google Play App Signing {#from-google-play-app-signing} +#### 从 Google Play 应用签名获取证书指纹{#from-google-play-app-signing} 如果您使用的是 [Google Play 应用签名](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -158,7 +201,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 ![A screenshot of the App signing page in the Google Play Console](@images/sig-v3/google-play-signing.png) -#### From Huawei AppGallery App Signing {#from-huawei-appgallery-app-signing} +#### 从 Huawei AppGallery 应用签名获取证书指纹{#from-huawei-appgallery-app-signing} 如果您使用的是 Huawei AppGallery 应用签名，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -188,7 +231,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -### Add your digital certificate fingerprints to Adjust’s allowlist {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### 将您的数字证书指纹加入 Adjust 许可名单{#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} @@ -207,7 +250,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！您的指纹现已加入应用许可名单。 -## Test your app {#test-your-app} +## 测试应用\{\#test\-your\-app\} 您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 @@ -239,3 +282,10 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 如果这些字段没有缺失，且包含正确的信息，就说明签名库已经成功集成。如果字段中出现了不同的值，请再次检查集成步骤，或发送邮件到 [support@adjust.com](mailto:support@adjust.com) 获取支持。 一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/zh/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 + +## 更新签名库\{\#updating\-the\-signature\-library\} + +只要 Adjust SDK v5 发生更新，签名库就会同时自动更新。如果需要特定版本的签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/zh/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必将其停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： + +- 应用密钥已不再适用于安装报告。 +- 您已经在所有应用平台和商店中全面发布了应用的新版本。 diff --git a/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx index 6265306e65..03438a4600 100644 --- a/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx @@ -12,6 +12,12 @@ redirects: v5: /zh/sdk/ios/integrations/signature-library --- + + +本页面将介绍 Adjust SDK v4 的集成步骤。如果您使用的是 Adjust SDK v4，请打开左侧下拉菜单，选择对应的选项卡。 + + + Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 ## 操作前须知 \{\#before\-you\-begin\} @@ -34,25 +40,53 @@ Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说， - 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 - 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -### 更新签名库{#updating-the-signature-library} +## 集成签名库 \{\#integrate\-the\-signature\-library\} -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。您无需立即在 Adjust 中对应用逻辑或设置进行变更。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： + + -- 应用密钥已不再适用于安装报告。 -- 您已经在所有应用平台和商店中全面发布了应用的新版本。 +签名库已在[GitHub](https://github.com/adjust/adjust_signature_sdk/releases/) 上发布，并从版本 `3.20.1` 起传输至 Cocoapod。要向您的项目添加签名库，请将以下行附加到您的 `Podfile` 中 \(请更改为[最新可用](https://github.com/adjust/adjust_signature_sdk/releases/latest)版本 \)： + +```ruby +pod 'AdjustSignature', '~> x.x.x' +``` + +`3.24.1` 及更高版本也提供 Beta 版发布要向您的项目添加签名库，请将以下行附加到您的 `Podfile` 中 \(请更改为[最新可用](https://github.com/adjust/adjust_signature_sdk/releases)版本\)： + +```ruby +pod 'AdjustSignature', 'x.x.x-beta' +``` + +一切就绪！签名库现已集成到您的项目中。 -## 集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} + + + +`3.20.1` 及更高版本也提供 SPM 支持。要添加签名库，请将签名库添加至您的 Xcode 项目中： + +1. 选择 **File —> Swift Packages —> Add Package Dependency** +2. 在出现的文本框中输入签名的 GitHub 地址：[https://github.com/adjust/adjust_signature_sdk](https://github.com/adjust/adjust_signature_sdk) +3. 在 **Version** 字段输入要使用的库版本。请查看[发布页面](https://github.com/adjust/adjust_signature_sdk/releases/latest)，找到最新版本。 + +此外，`3.24.1` 及更高版本也提供 Beta 发布的 SPM 支持。要添加签名库，请将签名库添加至您的 Xcode 项目中： + +1. 选择 **File —> Swift Packages —> Add Package Dependency** +2. 在出现的文本框中输入签名的 GitHub 地址：[https://github.com/adjust/adjust_signature_sdk](https://github.com/adjust/adjust_signature_sdk) +3. 在 **Branch** 字段中输入 `release/vx.xx`。将 `x.xx` 替换为[发布页面](https://github.com/adjust/adjust_signature_sdk/releases)中最新的主要版本和次要版本，例如`release/v3.24`。 -Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 +定向 `main` 分支可能意味着要调取 Beta 版本。 -请按照下列步骤操作，将签名库集成入您的 iOS 项目中。 +一切就绪！签名库现已集成到您的项目中。 + + + -1. [从 GitHub 下载`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip`文档](https://github.com/adjust/adjust_signature_sdk/releases/latest)。 -2. 解压缩文档，并将`AdjustSigSdk.xcframework`复制到项目的目录中。 +1. 从 GitHub[获取最新的稳定版](https://github.com/adjust/adjust_signature_sdk/releases/latest)或[Beta](https://github.com/adjust/adjust_signature_sdk/releases) Dynamic XCFramework 版。 +2. 解压缩文档，并将 `AdjustSigSdk.xcframework` 复制到项目的目录中。 3. 在 Xcode 中，在 **项目导航** 中选择您的项目。 4. 在左侧选择对象。 5. 选择 **General** 选项卡，展开 **Frameworks, Libraries and Embedded Content** 群组。 @@ -70,6 +104,9 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。 + + + ## 测试应用\{\#test\-your\-app\} 您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 @@ -108,3 +145,10 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 ### Upload symbols failed 在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 + +## 更新签名库\{\#updating\-the\-signature\-library\} + +要更新签名库，请用新版本替换现有的签名库，然后重新运行测试。您无需立即在 Adjust 中对应用逻辑或设置进行变更。[如果密钥 ID 满足以下条件，请务必将其停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： + +- 应用密钥已不再适用于安装报告。 +- 您已经在所有应用平台和商店中全面发布了应用的新版本。 diff --git a/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx index ae4a826c01..b0d3288786 100644 --- a/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx @@ -12,13 +12,19 @@ redirects: v4: /zh/sdk/ios/v4/integrations/signature-library --- + + +本页面将介绍 Adjust SDK v5 的集成步骤。如果您使用的是 Adjust SDK v4，请打开左侧下拉菜单，选择对应的选项卡。 + + + Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 ## 操作前须知 \{\#before\-you\-begin\} 要将 Adjust 签名库集成到您的 iOS 应用，请确保满足下列条件： -- 正在使用的 Adjust SDK 为 **4\.35\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 +- 正在使用的 Adjust SDK 为 **5\.0\.0 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 - 支持 iOS 或 tvOS **12 或更高** 版本。 @@ -34,25 +40,57 @@ Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说， - 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 - 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -### 更新签名库{#updating-the-signature-library} +## 集成签名库 \{\#integrate\-the\-signature\-library\} -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。您无需立即在 Adjust 中对应用逻辑或设置进行变更。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： + -- 应用密钥已不再适用于安装报告。 -- 您已经在所有应用平台和商店中全面发布了应用的新版本。 +在大多数情况下，SDK 签名库默认包含在 SDK v5 中。您应当仅在收到 SDK 提示，或需要特定 SDK 签名库版本时，才进行单独集成。 + + + + +签名库已在[GitHub](https://github.com/adjust/adjust_signature_sdk/releases/) 上发布，并从版本 `3.20.1` 起传输至 Cocoapod。要向您的项目添加签名库，请将以下行附加到您的 `Podfile` 中 \(请更改为[最新可用](https://github.com/adjust/adjust_signature_sdk/releases/latest)版本\)： + +```ruby +pod 'AdjustSignature', '~> x.x.x' +``` + +`3.24.1` 及更高版本也提供 Beta 版发布要向您的项目添加签名库，请将以下行附加到您的 `Podfile` 中 \(请更改为[最新可用](https://github.com/adjust/adjust_signature_sdk/releases)版本\)： + +```ruby +pod 'AdjustSignature', 'x.x.x-beta' +``` -## 集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} +一切就绪！签名库现已集成到您的项目中。 + + + + +`3.20.1` 及更高版本也提供 SPM 支持。要添加签名库，请将签名库添加至您的 Xcode 项目中： + +1. 选择 **File —> Swift Packages —> Add Package Dependency** +2. 在出现的文本框中输入签名的 GitHub 地址：[https://github.com/adjust/adjust_signature_sdk](https://github.com/adjust/adjust_signature_sdk) +3. 在 **Version** 字段输入要使用的库版本。请查看[发布页面](https://github.com/adjust/adjust_signature_sdk/releases/latest)，找到最新版本。 + +此外，`3.24.1` 及更高版本也提供 Beta 发布的 SPM 支持。要添加签名库，请将签名库添加至您的 Xcode 项目中： + +1. 选择 **File —> Swift Packages —> Add Package Dependency** +2. 在出现的文本框中输入签名的 GitHub 地址：[https://github.com/adjust/adjust_signature_sdk](https://github.com/adjust/adjust_signature_sdk) +3. 在 **Branch** 字段中输入 `release/vx.xx`。将 `x.xx` 替换为[发布页面](https://github.com/adjust/adjust_signature_sdk/releases)中最新的主要版本和次要版本，例如`release/v3.24`。 -Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 +定向 `main` 分支可能意味着要调取 Beta 版本。 -请按照下列步骤操作，将签名库集成入您的 iOS 项目中。 +一切就绪！签名库现已集成到您的项目中。 + + + -1. [从 GitHub 下载`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip`文档](https://github.com/adjust/adjust_signature_sdk/releases/latest)。 -2. 解压缩文档，并将`AdjustSigSdk.xcframework`复制到项目的目录中。 +1. 从 GitHub[获取最新的稳定版](https://github.com/adjust/adjust_signature_sdk/releases/latest)或[Beta](https://github.com/adjust/adjust_signature_sdk/releases) Dynamic XCFramework 版。 +2. 解压缩文档，并将 `AdjustSigSdk.xcframework` 复制到项目的目录中。 3. 在 Xcode 中，在 **项目导航** 中选择您的项目。 4. 在左侧选择对象。 5. 选择 **General** 选项卡，展开 **Frameworks, Libraries and Embedded Content** 群组。 @@ -70,6 +108,9 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。 + + + ## 测试应用\{\#test\-your\-app\} 您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 @@ -108,3 +149,10 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 ### Upload symbols failed 在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 + +## 更新签名库\{\#updating\-the\-signature\-library\} + +只要 Adjust SDK v5 发生更新，签名库就会同时自动更新。如果需要特定版本的签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/zh/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必将其停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： + +- 应用密钥已不再适用于安装报告。 +- 您已经在所有应用平台和商店中全面发布了应用的新版本。 diff --git a/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx index 7ab5a1c1bd..ecc03200d2 100644 --- a/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx @@ -12,13 +12,19 @@ redirects: v5: /zh/sdk/unity/integrations/signature-library --- + + +本页面将介绍 Adjust SDK v4 的集成步骤。如果您使用的是 Adjust SDK v4，请打开左侧下拉菜单，选择对应的选项卡。 + + + Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 ## 操作前须知 \{\#before\-you\-begin\} -在 [3\.32\.0 或更高版本](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)中，SDK 签名库被配置为使用 [16KB 的页面大小](https://developer.android.com/guide/practices/page-sizes)。 +在 [3\.32\.0 或更高版本](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)中，签名库被配置为使用 [16KB 的页面大小](https://developer.android.com/guide/practices/page-sizes)。 @@ -41,24 +47,11 @@ Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说， - 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 - 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -### 更新签名库{#updating-the-signature-library} - -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/zh/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： - -- 应用密钥已不再适用于安装报告。 -- 您已经在所有应用平台和商店中全面发布了应用的新版本。 - -## 集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} - - - -Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 - - +## 集成签名库 \{\#integrate\-the\-signature\-library\} 请按照下列步骤操作，将签名库集成入您的 Unity 项目中。 -1. [从 GitHub 调取](https://github.com/adjust/adjust_signature_sdk/releases/latest)签名库内容。 +1. 从 GitHub[获取最新的稳定版](https://github.com/adjust/adjust_signature_sdk/releases/latest)或[Beta](https://github.com/adjust/adjust_signature_sdk/releases) 版。 2. 将安卓归档 \(`.aar`\) 文件放在 Unity 项目的 `Assets/Adjust/Android` 目录中。 3. 将 iOS 静态框架 \(`.a`\) 放入 Unity 项目的 `Assets/Adjust/iOS` 目录中。 @@ -244,3 +237,10 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 在 Unity Editor 2018 和更新版本中，您可能会遇到 " **Unknown CPU Architecture** " 的错误信息。当 Unity Editor 试图针对非 iOS 平台应用 iOS 静态框架 \(`.a`\) 时，就会出现该报错。要解决该问题，请选择 `AdjustSigSdk.a` 文件，然后找到 **Import Settings** \(导入设置\) 菜单，取消勾选 **iOS** 以外的所有平台。 ![A screenshot of the AdjustSdk Import Settings in Unity Editor](@images/sig-v3/unity-import-settings.png) + +## 更新签名库\{\#updating\-the\-signature\-library\} + +要更新签名库，请用新版本替换现有的签名库，然后重新运行测试。您无需立即在 Adjust 中对应用逻辑或设置进行变更。[如果密钥 ID 满足以下条件，请务必将其停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： + +- 应用密钥已不再适用于安装报告。 +- 您已经在所有应用平台和商店中全面发布了应用的新版本。 diff --git a/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx index 23419b71b6..c0ccf01ef7 100644 --- a/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx @@ -12,20 +12,26 @@ redirects: v4: /zh/sdk/unity/v4/integrations/signature-library --- + + +本页面将介绍 Adjust SDK v5 的集成步骤。如果您使用的是 Adjust SDK v4，请打开左侧下拉菜单，选择对应的选项卡。 + + + Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 ## 操作前须知 \{\#before\-you\-begin\} -在 [3\.32\.0 或更高版本](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)中，SDK 签名库被配置为使用 [16KB 的页面大小](https://developer.android.com/guide/practices/page-sizes)。 +在 [3\.32\.0 或更高版本](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)中，签名库被配置为使用 [16KB 的页面大小](https://developer.android.com/guide/practices/page-sizes)。 要将签名库集成到您的 Unity 应用，请确保满足下列条件： - 正在使用的安卓API 为 **21 或更高版本** 。 -- 正在使用的 Adjust SDK 为 **4\.37\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 +- 正在使用的 Adjust SDK 为 **5\.0\.0 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 - 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 @@ -41,24 +47,17 @@ Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说， - 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 - 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -### 更新签名库{#updating-the-signature-library} - -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/zh/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： - -- 应用密钥已不再适用于安装报告。 -- 您已经在所有应用平台和商店中全面发布了应用的新版本。 - -## 集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} +## 集成签名库 \{\#integrate\-the\-signature\-library\} -Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 +如果您使用的是 [External Dependency Manager for Unity \(EDM4U\)](https://github.com/googlesamples/unity-jar-resolver)，那么就可以跳过这一步。 请按照下列步骤操作，将签名库集成入您的 Unity 项目中。 -1. [从 GitHub 调取](https://github.com/adjust/adjust_signature_sdk/releases/latest)签名库内容。 +1. 从 GitHub[获取最新的稳定版](https://github.com/adjust/adjust_signature_sdk/releases/latest)或[Beta](https://github.com/adjust/adjust_signature_sdk/releases) 版。 2. 将安卓归档 \(`.aar`\) 文件放在 Unity 项目的 `Assets/Adjust/Android` 目录中。 3. 将 iOS 静态框架 \(`.a`\) 放入 Unity 项目的 `Assets/Adjust/iOS` 目录中。 @@ -244,3 +243,10 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 在 Unity Editor 2018 和更新版本中，您可能会遇到 " **Unknown CPU Architecture** " 的错误信息。当 Unity Editor 试图针对非 iOS 平台应用 iOS 静态框架 \(`.a`\) 时，就会出现该报错。要解决该问题，请选择 `AdjustSigSdk.a` 文件，然后找到 **Import Settings** \(导入设置\) 菜单，取消勾选 **iOS** 以外的所有平台。 ![A screenshot of the AdjustSdk Import Settings in Unity Editor](@images/sig-v3/unity-import-settings.png) + +## 更新签名库\{\#updating\-the\-signature\-library\} + +只要 Adjust SDK v5 发生更新，签名库就会同时自动更新。如果需要特定版本的签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/zh/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必将其停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： + +- 应用密钥已不再适用于安装报告。 +- 您已经在所有应用平台和商店中全面发布了应用的新版本。