Skip to content

Android Studio で開発を始める

Android Studio で開発するアプリケーションに Brother Print SDK を組み込む方法を紹介します。

SDK を追加する

SDK を Android Studio に追加する方法は２つあります。

Android Studio のウィザードに従う

  • メニューの File > Project Structure... > Dependencies の順にクリックします。
  • モジュールを選択し、Declared Dependencies の "+" 記号をクリックして、JAR/AAR Dependency を選択します。
  • BrotherPrintLibrary.aar のパスを入力し、依存関係の種類を選択して OK をクリックします。
  • モジュールの build.gradle が以下のように更新されていることを確認します：
dependencies {
    implementation project(":BrotherPrintLibrary")
}

手動で build.gradle に依存ライブラリを追記する

  1. プロジェクトルートディレクトリ以下の任意の場所に libs ディレクトリを作成し、そのディレクトリの中に BrotherPrintLibrary.aar を置く
    例：<#Repository Root#>/app/libs/BrotherPrintLibrary.aar

  2. プロジェクトルートの build.gradle に以下のように flatDir{} を追加する

allprojects {
    repositories {
        google()
        jcenter()
        flatDir {
            dirs 'libs'
        }
    }
}
  1. アプリルートの build.gradle に以下のように dependencies{} を追加する
dependencies {
    implementation(name:'esprintsdk-lib-android-release', ext:'aar')
}

パーミッション設定を追加する

Manifest.xml に次のようにパーミッション設定を記述する。

<!-- For Wi-Fi -->
<uses-permission android:name="android.permission.INTERNET" />

<!-- For Bluetooth -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

<!-- For Bluetooth Low Energy, Android 11 and earlier-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

<!-- For Bluetooth Low Energy, Android 12 and later -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN"
        android:usesPermissionFlags="neverForLocation"
        tools:targetApi="s" />

アプリケーションが PrinterInfo.workPath を利用しない場合は android.permission.WRITE_EXTERNAL_STORAGE を設定する必要はありません。

SDK の機能を実装する

プリンターと通信するためのサンプルコードです。詳細は各ガイドを参照してください。

import com.brother.sdk.lmprinter.Channel;
import com.brother.sdk.lmprinter.OpenChannelError;
import com.brother.sdk.lmprinter.PrinterDriver;
import com.brother.sdk.lmprinter.PrinterDriverGenerateResult;
import com.brother.sdk.lmprinter.PrinterDriverGenerator;

void yourGreatFeature() {
    Channel channel = Channel.newWifiChannel("IPAddress.of.your.printer");

    PrinterDriverGenerateResult result = PrinterDriverGenerator.openChannel(channel);
    if (result.getError().getCode() != OpenChannelError.ErrorCode.NoError) {
        Log.e("", "Error - Open Channel: " + result.getError().getCode());
        return;
    }
    Log.d("", "Success - Open Channel");

    PrinterDriver printerDriver = result.getDriver();
    //
    // Put any code to use printer
    //

    printerDriver.closeChannel();
}

プリンターと USB 接続する場合、Android 端末で通信を許可する必要があります。