Android アプリ・ラッピングのトラブルシューティング・ガイド

このトピックでは、アプリ・ラッピング中に発生する可能性がある一般的な問題およびそれらの問題の修正方法について説明します。

エラーまたは例外 サマリー 回避策
ERROR_APP_COMPLIANCE_D8 = -24 MaaS360® は現在、 D8 dexer でコンパイルされたアプリのラッピングをサポートしていません。 D8 チェックを無効にするには、以下のいずれかのオプションを選択します。
  • Android Studio の gradle.properties ファイルに移動し、 android.enableD8 を false に設定し、アプリを再度コンパイルする。
  • MaaS360で disableD8Check パラメーターを false に設定します。 注意: D8 チェックを無効にすると、ラップされたアプリの動作の変更が発生する可能性があります。
USES_64_BIT_LIBRARY_ERROR_CODE = -1 64 ビットのネイティブ (so) ライブラリーを使用するアプリケーションでの暗号化はサポートされていません。 .apk ファイル内のすべての 64 ビット・ライブラリーを削除し、アプリを再度ラップします。
USES_64_BIT_LIBRARY_WITH_ANALYTICS_ERROR_CODE = -5 64 ビットのネイティブ (so) ライブラリーを使用するアプリケーションでのアプリ分析はサポートされていません。 アプリ分析を無効にし、アプリを再度ラップします。 アプリ分析を無効にするには、以下のようにします。
  1. MaaS360 Portalにログインし、 Apps > Catalog > Add > Android > Enterprise App for Android > Wrapping and Signing workflowと進みます。
  2. 「アプリ分析の有効化」オプションをクリアします。
USES_SQLCIPHER_ANALYTICS_ERROR_CODE = -8 暗号化に SQLCipher バージョン 2.x および 3.x を使用するアプリケーションでのアプリ分析はサポートされていません。 3.x より後の SQLCipher バージョンを使用し、アプリを再度ラップします。
ERROR_OCCURRED_WHILE_GENERATING_SPLIT_DEX_CLASSES = -21 アプリに多数のライブラリーが含まれている場合、 MaaS360 は例外をスローします。 MaaS360 は、このようなシナリオを克服するために dex や multidex の分割などの機能をサポートしていますが、DEX ファイルの区分化にかかわらず、DEX ファイル内で参照されるクラス・ファイルの数が許容限度を超えると、例外がトリガーされます。 MaaS360 ポータルの packagesToRemove パラメーターを使用して、サポート・ライブラリーや不要な再生サービスなどの特定のパッケージを最終 APK ファイルから削除します。 例: packagesToRemove=com.sun,com.apple
ClassNotFoundException, NoClassDefFoundError Retrofit ライブラリーが使用されている場合、ライブラリー内の responseBodyConverter メソッドがこれらの例外をスローします。 protectRetrofitMethod=true を設定して、例外を回避してください。

トラブルシューティング

ゲートウェイが動作しない場合は、ProGuardが OkHttp3ライブラリに適用されていないことを確認してください。