Android用SDKを導入したい

動作環境について

Androidのb→dash mobile SDKにおいて、推奨環境と動作環境について紹介します。
下記に、b→dash mobile SDK（v5.0.2）の推奨環境と動作環境についてまとめましたのでご参照ください。

本SDKの計測は、以下のプラットフォームで動作確認を行っております。

利用している外部ライブラリについて

b→dash Mobile SDK利用している外部ライブラリは以下の一覧をご参照ください。

※1. サポートライブラリは対象外となります
本SDK では AndroidX を採用しているため、サポートライブラリを利用している場合はAndroidX への移行を行う必要があります。

<app/build.gradle>

android{
　　compileSdkVersion 28
..
}

<build.gradle>

dependencies{
　　classpath 'com.android.tools.build:gradle:3.2.0'
}

android.enableJetifier=true
android.useAndroidX=true

<app/build.gradle>
dependencies { 
・・
implementation 'com.squareup.okhttp3:okhttp:4.9.3'
・・
}

SDKのインストール

ここではb→dash mobile SDKのAndroidアプリケーションへのインストール方法について説明します。

SDKファイルの組み込み

SDKファイルは、貴社カスタマーサクセス担当からzipファイル形式でお渡しさせていただきます。カスタマーサクセス担当から共有されたZIPファイルを展開し「bdash-mobile-sdk.aar」をライブラリとしてプロジェクトへ導入します。

プロジェクト導入以降の操作は Android Stuidio 環境での説明になります。
導入のサンプルコードは全て Java 言語で記載していますので、Kotlin を利用されている場合は適宜読み替えて導入をお願いいたします。

build.gradleの編集

b→dash mobile SDKのコンパイルに必要な設定をプロジェクトのbuild.gradleに追加します。
以下はAndroid Studio 3.6.3以降のサンプルコードとなります。

<app/build.gradle>
dependencies {
implementation(name:'bdash-mobile-sdk', ext:'aar')
implementation 'com.google.android.gms:play-services-ads-identifier:17.0.0’

// Push通知を利用する場合は必須
implementation 'com.google.firebase.gms:firebase-messaging:20.2.4'

// AndroidX を利用.
implementation 'androidx.appcompat:appcompat:1.2.0'

// Okhttp3 を利用
implementation 'com.squareup.okhttp3:okhttp:4.9.3'

apply plugin: 'com.google.gms.google-services'

<build.gradle>
dependencies {

// バージョンについては AndroidStudio / gradle の利用バージョンに応じて設定する
classpath 'com.android.tools.build:gradle:3.6.4'
classpath 'com.google.gms:google-services:4.3.5'

configurations.all {
　resolutionStrategy.eachDependency { details ->
　　if (details.requested.group == 'androidx.core') {
　　　details.useVersion '【利用バージョンを指定します】'
　　}
　}
}

AndroidManifest.xml の編集

b→dash mobile SDKの動作/実行に必要な設定をAndroidManifest.xmlに追加します。

以下のパーミッションの設定を「<application>」の前に追加します

追加の際は、下記パラメーターの記載例をご参照ください。

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.VIBRATE" />

以下の<meta-data> を manifest の 「<application>」 内に追加します

追加の際は、下記パラメーターの記載例をご参照ください。

<meta-data android:name="APP_BDASH_ACCOUNT_ID"
android:value="カスタマーサクセス担当より連絡しますので、その値を入力してください。" />

<meta-data android:name="APP_BDASH_APP_ID"
android:value="カスタマーサクセス担当より連絡しますので、その値を入力してください。" />

Proguard の除外設定

Proguard を使って難読化される場合は、アプリケーションの app ディレクトリに有る proguard-project.txt 又は proguard-rules.pro に以下の設定を追加してください。

-keep class com.f_scratch.bdash.mobile.analytics.**{
*;
}