2. ライブラリ追加方法

2.1. プロジェクトへ追加する

ライブラリはMavenリポジトリとAARファイルに対応しています。アプリケーション構成に合わせてライブラリを追加してください。

重要

SDK V5.17.1より、StarIOおよびStarIOExtensionライブラリがAARファイルに変更されました。

ライブラリについて、最新のSDKをスター精密グローバルサポートサイトからダウンロードしてご確認ください。

2.1.1. Mavenリポジトリを使用する場合

1. 以下のコードをapp/build.gradleに挿入します。

dependencies {
    implementation 'com.starmicronics:stario:starioVersion'
    implementation 'com.starmicronics:starioextension:starioextensionVersion'
    implementation 'com.starmicronics:stariodevicesetting:stariodevicesettingversion'
    ...
}

注釈

ライブラリの最新バージョンはexamplesフォルダにある各プロジェクトのapp/build.gradleを参照ください。

2.1.2. 手動でリンクする場合

libsフォルダ以下にあるライブラリを選択します。
ライブラリ名
stario.aar

starioextension.aar

StarIODeviceSetting.aar
プロジェクトのlibsフォルダにライブラリをコピーします。

以下のコードをapp/build.gradleに挿入してください。

dependencies {
    implementation(name: 'stario', ext: 'aar')
    implementation(name: 'starioextension', ext: 'aar')
    implementation(name: 'StarIODeviceSetting', ext: 'aar')
    ...
}
注釈

starioextension.aar, StarIODeviceSetting.aarを使用する場合は、stario.aarを併せてリンクしてください

(オプション) TSP100シリーズにおいてQRコードもしくはPDF417の印刷を行う場合は、以下の宣言も追加します。

dependencies {
    implementation 'com.google.zxing:core:3.2.1'
    ...
}

以下のコードをbuild.gradleに挿入してください。

allprojects {
    repositories {
        flatDir {
            dirs 'libs'
        }
        ...
    }
    ...
}

2.2. プロジェクト設定

2.2.1. AndroidManifest.xmlへ項目を設定する

AndroidManifest.xmlファイルをダブルクリックします。

TCP/IP接続の場合、TCP/IP接続の利用に関する追記を行います。Bluetooth接続の場合、Bluetooth接続の利用に関する追記を行います。

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />

注釈

stario.aarをリンクすると、上記の項目は自動でアプリケーションのAndroidManifest.xmlに追加されます。

targetSdkVersionを31以降に設定する場合は下記のようになります。 Android12の新しいBluetooth権限

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.BLUETOOTH"
    android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"
    android:maxSdkVersion="30" />

<uses-permission android:name="android.permission.BLUETOOTH_SCAN"
    android:usesPermissionFlags="neverForLocation"
    tools:targetApi="31" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

USB接続の場合、USB接続の利用に関する追記を行います。

<intent-filter>
    <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
    <action android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED" />
</intent-filter>

<meta-data android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" android:resource="@xml/device_filter" />
<meta-data android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED" android:resource="@xml/accessory_filter" />

2.2.2. device_filter.xml、accessory_filter.xmlへ項目を設定する

device_filter.xml（またはaccessory_filter.xml）ファイルをダブルクリックします。

USB接続の場合、USB接続の利用に関する追記を行います。

device_filter.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <usb-device class="255" subclass="66" protocol="1" />
    <usb-device vendor-id="1305" product-id="0001" />   <!--IFBD-HU05/06, IFBD-HU07/08 - printerClass-->
    <usb-device vendor-id="1305" product-id="0002" />   <!--IFBD-HU05/06, IFBD-HU07/08 - vendorClass-->
    <usb-device vendor-id="1305" product-id="0003" />   <!--TSP100U/ECO/IIIU/IV  - printerClass-->
    <usb-device vendor-id="1305" product-id="0004" />   <!--TSP100U/ECO       - vendorClass-->
    <usb-device vendor-id="1305" product-id="0005" />   <!--TSP100GT/IIIU     - printerClass-->
    <usb-device vendor-id="1305" product-id="0006" />   <!--TSP100GT          - vendorClass-->
    <usb-device vendor-id="1305" product-id="0009" />   <!--FVP10             - printerClass-->
    <usb-device vendor-id="1305" product-id="0010" />   <!--FVP10             - vendorClass-->
    <usb-device vendor-id="1305" product-id="0011" />   <!--BSC10             - printerClass-->
    <usb-device vendor-id="1305" product-id="0012" />   <!--BSC10             - vendorClass-->
    <usb-device vendor-id="1305" product-id="0017" />   <!--BSC10BR           - printerClass-->
    <usb-device vendor-id="1305" product-id="0067" />   <!--SM-S210i/230i     - mobile printer-->
    <usb-device vendor-id="1305" product-id="0023" />   <!--mPOP              - printerClass-->
    <usb-device vendor-id="1305" product-id="0071" />   <!--mC-Print3         - printerClass-->
    <usb-device vendor-id="1305" product-id="0073" />   <!--mC-Print2         - printerClass-->
    <usb-device vendor-id="1305" product-id="0025" />   <!--mC-Label3         - printerClass-->
    <usb-device vendor-id="1305" product-id="0075" />   <!--SK1-211/221/V211  - printerClass-->
    <usb-device vendor-id="1305" product-id="0077" />   <!--SK1-311/321/V311  - printerClass-->
</resources>

accessory_filter.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <usb-accessory model="Star TSP143IV-UE" manufacturer="STAR"/>
    <usb-accessory model="Star TSP143IV-UE SK" manufacturer="STAR"/>
    <usb-accessory model="mC-Label3" manufacturer="Star Micronics"/>
    <usb-accessory model="mC-Print3" manufacturer="Star Micronics"/>
    <usb-accessory model="mPOP" manufacturer="Star Micronics"/>
</resources>

device_filter.xml、accessory_filter.xmlに記述されたStar USBプリンターについては、接続許可時にチェックボックスにチェックをいれることで、ケーブルを挿抜してもアプリケーションを再インストールしない限り許可ダイアログが表示されなくなります。また、挿抜時サンプルアプリケーションが自動で起動するようになります。

TSP100IIIUはメモリスイッチの設定により、product-idをTSP100U/ECO 互換、もしくはTSP100GT互換に変更できます。メモリスイッチの設定は専用ソフトウェアから行えます。ユーティリティ/ドライバを参照ください。