自動署名サービス
アプリをDigital Labにアップロードするときにユーザーがアプリに署名できるようにするには、管理者が署名サービスを設定する必要があります。
アプリ署名サービスについて
Digital Labレコードおよび再生ライブラリを使用してアプリを再パッケージ化する場合は常に、アプリに再署名する必要があります。デフォルトでは、Androidアプリはデバッグ証明書で署名されており、管理者は追加のアクションを行う必要はありません。iOSアプリの場合、またはGoogleマップや認証サービスなどのプライベートキーを必要とするサービスを使用するAndroidアプリの場合、管理者は自動署名用にDigital Labを設定する必要があります。
アプリを手動でパッケージ化して署名し、Digital Labにアップロードすることもできます。詳細については、Androidアプリを手動でパッケージ化するまたはパッケージサービスを使用してiOSアプリを手動でパッケージ化するを参照してください。
iOSアプリの署名サービス
iOSアプリがDigital Labにアップロードされたときに署名できるように、iOS署名サービスを設定しました。署名サービスは、エージェントへの署名にも使用されます。詳しくはiOS署名サービスを参照してください。
プライベートキーを必要とするAndroidアプリの署名サービス
このセクションは、UFT Digital Labにのみ関連します。
通常、Digital Labへのアップロード時にAndroidアプリをパッケージ化する場合、追加のアクションは必要ありません。Androidパッケージャー用に構成された設定を表示するには、管理 > 設定タブをクリックし、[Androidパッケージングサービス] を選択します。詳細については、管理設定を参照してください。
デフォルトでは、Digital Labは、デバッグ証明書を使用してアプリに署名します。アプリでプライベートキーを必要とするサービス (Googleマップや認証サービスなど) を使用している場合は、パッケージ化プロセス中に独自のプライベートキーを使用してアプリに署名する必要があります。Digital Labがプライベートキーを使用して署名できるようにするには、署名の詳細を使用するようにアプリパッケージャーを構成する必要があります。
Digital Labを構成して、独自の証明書でアプリに自動的に署名するには:
- Digital Labサーバーマシンでパッケージャプロパティファイルを開きます。
Linux: <サーバーインストールフォルダーへのパス>/server/conf/packager.properties
Windows: <サーバーインストールフォルダーへのパス>\server\conf\packager.properties
- 次の情報を入力します。
- ANDROID_KEYSTORE_PATH = キーストアへのパス。これは、プライベートキーのセットを含むバイナリファイルです。
- ANDROID_KEY_PASSWORD = アプリの署名に使用されるプライベートキーのパスワード。
- ANDROID_STORE_PASSWORD =キーストアのパスワード。
- ANDROID_ALIAS_NAME = キーストア内のプライベートキーエントリを識別するために使用される名前。
注: 4つの値すべてが必要です。いずれかの値を空のままにすると、アプリのパッケージ化プロセスは失敗します。
UFT Digital Lab Managed SaaSおよびValueEdge Digital Labの自動署名
iOSおよびAndroidの自動署名サービスを設定するには:
iOS |
組み込み署名サービスを構成します。詳しくはiOS署名サービスを参照してください。このサービスがセットアップされると、Digital Labにアップロードされたエージェントと他のすべてのアプリは、Apple証明書とプロビジョニングプロファイルで署名できます。 または、自動署名を設定しないことを選択した場合は、iOS Enablerを使用してエージェントとアプリに手動で署名できます。詳細については、iOS Enablerを使用してiOSアプリを手動でパッケージ化するを参照してください。 |
Android |
デフォルトでは、Digital Labは、デバッグ証明書を使用してアプリに署名します。Googleマップや認証サービスなど、秘密鍵を必要とするサービスをアプリで使用する場合は、アプリを手動でパッケージ化してからアップロードできます。詳細については、Androidアプリを手動でパッケージ化するを参照してください。 |
アプリパッケージャーのトラブルシューティング
パッケージングプロセスが成功しない場合があります。Digital Labがアプリのパッケージバージョンを作成できない場合、通知が表示されます。パッケージ化はテストに必須ではありませんが、アプリをパッケージ化する必要がある特定のテストケースがあります。詳しくはパッケージアプリをいつ使用するかを参照してください。
次の理由により、パッケージ化が成功しない場合があります。
- [管理] > [設定] でパッケージングサービスに定義した設定を確認してください。
Android:
- 独自のキーを使用してAndroidアプリに署名している場合は、サーバーマシンのアプリパッケージャーファイルの詳細が正しいことを確認してください。
iOS:
- リモートパッケージャーを使用している場合は、パッケージャーサービスがインストールされているMacマシンに正しい設定を提供していること、または組み込みパッケージングサービスを使用している場合は、プロビジョニングプロファイルとApple証明書が有効であることを確認してください。
- パッケージングサービスログを確認してください。パッケージャーUIの右上にあるバージョン情報アイコンをクリックして、ログファイルをダウンロードします。
- 元のアプリケーションをもう一度アップロードしてみてください。
- Androidアプリ: Android Enablerツールを使用してアプリをパッケージ化した場合は、最新バージョンを使用していることを確認してください。
- iOSアプリ: リモート署名サービスまたはiOS Enablerを使用してアプリをパッケージ化する場合は、署名サービス/iOS EnablerのバージョンがDigital Labサーバーのバージョンと一致していることを確認してください。詳細については、パッケージサービスを使用してiOSアプリを手動でパッケージ化するか、iOS Enablerを使用してiOSアプリを手動でパッケージ化するを参照してください。
- アップロードできる最大ファイルサイズは1GBです。
iOSアプリを正常にパッケージ化するには、プロビジョニングプロファイルでチーム識別子を指定する必要があります。
Digital Labアプリをアップロードする際、パッケージングエラーが発生した場合は、このリストを使用してエラーの原因を特定してください。サポートが必要な場合は、管理者に連絡してください。
エラーコード |
説明 |
2802 |
一般的なパッケージエラーが発生しました。 |
2803 |
iOS Enablerのバージョンが正しくないため、アプリケーションをアップロードできませんでした。詳細については、パッケージサービスを使用してiOSアプリを手動でパッケージ化するを参照してください。 |
2807 |
アプリパッケージャーのバージョンは、このバージョンのDigital Labサーバーと互換性がありません。 |
2808 |
アプリパッケージャーが正しく構成されていません。 |
2809 |
Digital Labサーバーのアップグレードにより、このアプリケーションは存在しなくなりました。アプリケーションを再度アップロードする必要があります。 |
2810 |
アプリパッケージャーのプロパティの1つ (PROTOCOL/IP/PORT) が欠落しているか、正しくありません。管理者は、[管理] > [設定] の [Android/iOSパッケージングサービス] セクションでこれらの値を変更できます。 |
2821 |
一般的なエラー: アプリケーションをiOS Enablerでパッケージ化できませんでした。 |
2822 |
iOS Enablerの使用方法が正しくないため、アプリケーションをパッケージ化できませんでした。詳細については、パッケージサービスを使用してiOSアプリを手動でパッケージ化するを参照してください。 |
2823 |
以前はXcodeを使用して静的ライブラリを使用してアプリを手動でパッケージ化していたため、アプリケーションをパッケージ化できませんでした。 |
2824 |
iOS Enablerがアプリにコード署名できなかったため、アプリケーションをパッケージ化できませんでした。詳細については、パッケージサービスを使用してiOSアプリを手動でパッケージ化するを参照してください。 |
2825 |
iOS Enablerが署名Dylibをコーディングできなかったため、アプリケーションをパッケージ化できませんでした。UFT Mobile dylibファイルを確認してください。詳細については、パッケージサービスを使用してiOSアプリを手動でパッケージ化するを参照してください。 |
2826 |
iOS EnablerがDylibを挿入できなかったため、アプリケーションをパッケージ化できませんでした。詳細については、パッケージサービスを使用してiOSアプリを手動でパッケージ化するを参照してください。 |
2827 |
Dylibが無効なため、アプリケーションをパッケージ化できませんでした。詳細については、パッケージサービスを使用してiOSアプリを手動でパッケージ化するを参照してください。 |
2829 | プロビジョニングプロファイルにチーム識別子がないため、アプリケーションをパッケージ化できませんでした。 |
2850 |
アプリが正常にアップロードされ、Digital Labがアプリのパッケージバージョンを作成しました。ただし、リモートコンテンツのデバッグを有効にできませんでした。 注: このエラーの場合、パッケージ化されていないAndroidアプリでスパイアクションを記録、再生、または実行することはできません。回避策として、手動でAndroidアプリのリモートコンテンツデバッグを有効にするを試してください。または、パッケージアプリを使用します。 |
2851 |
アプリは正常にアップロードされました。ただし、Digital Labは、アプリのパッケージバージョンを作成できず、リモートコンテンツのデバッグも有効にできませんでした。 注: このエラーについては、手動でAndroidアプリのリモートコンテンツデバッグを有効にするを試してください。 |
その他の参照項目: