メインコンテンツへスキップ

インストール

依存関係の追加とパッケージマネージャーの設定
ステップ 1 — Mavenリポジトリを追加する

Android SDKはUnico独自のMavenリポジトリを通じて配布されます。ルートレベルのビルドファイルにあるrepositoriesブロックに追加してください:

build.gradle.kts (project)
allprojects {
repositories {
google()
maven { url = uri("https://maven-sdk.unico.run/sdk-mobile") }
}
}
ステップ 2 — AndroidXサポートを有効にする(必要な場合)

プロジェクトルートにあるgradle.propertiesに以下を追加してください:

gradle.properties
android.useAndroidX=true
Jetifier

AGP 8.6+のプロジェクトでは、Jetifierはデフォルトで無効になっています。AndroidXに移行していないレガシーなsupport-libraryアーティファクトにプロジェクトが依存している場合にのみandroid.enableJetifier=trueを追加してください — 不必要に有効にするとビルド時間が増加します。

ステップ 3 — SDK依存関係を追加する

モジュールレベルのビルドファイルにあるdependenciesブロックにacessobio-androidを追加してください。<latest_version>を現在のバージョン(6.3.0)に置き換えてください — 最新情報はリリースノートを参照してください:

app/build.gradle.kts (module)
dependencies {
implementation("com.acesso:acessobio-android:<latest_version>")
}
レガシーアーティファクト名について

Mavenグループcom.acessoおよびアーティファクト名acessobio-androidは、旧Acesso Digitalブランドを反映したものです — これらは公開されているアーティファクト識別子であり、このSDKバージョンでは変更されません。同じSDKは、APIリファレンスやその他のUnico資料ではUnicoCheckと呼ばれています。

ステップ 4 — Java互換性を設定する

min-26とのフレーム非互換を避けるため、同じモジュールレベルのビルドファイルのcompileOptionsに以下を追加してください:

app/build.gradle.kts (module)
android {
compileOptions {
sourceCompatibility = JavaVersion.VERSION_1_8
targetCompatibility = JavaVersion.VERSION_1_8
}
}
ステップ 5 — AndroidManifestにパーミッションを追加する

AndroidManifest.xmlに最低限必要なパーミッションとハードウェア機能の宣言を追加してください:

AndroidManifest.xml
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA" />
Play Store配信フィルタリング

<uses-feature>の宣言は、アプリにカメラが必要であることをPlay Storeに通知し、カメラを持たないデバイスへの配信を除外します。カメラなしのフォールバックパスがある場合のみandroid:required="false"を設定してください。

WebViewのシナリオ

標準的な生体認証フローにネイティブAndroid SDKを使用しながら、WebView内のWeb SDKを通じて特定のジャーニー(レガシーなオンボーディングフローや地域固有のエクスペリエンスなど)をレンダリングするハイブリッドアプリがあります。アプリがこのパターンに従っている場合、追加のパーミッションが必要です。完全なリストについてはWeb SDK統合ガイドを参照してください。