V5.20.2

Author: Tatsuki-Yamamoto2731

Changelog.md

@@ -1,3 +1,27 @@
+# Ver.5.20.2 (2026/06/30)
+
+## StarIO
+
+- Support Android 17.
+- Updated the `searchPrinter` / `getPort` APIs used for LAN communication to output an appropriate exception message when the `ACCESS_LOCAL_NETWORK` permission is not granted.
+
+## StarIOExtension
+
+- Support Android 17.
+
+## StarIODeviceSetting
+
+- Support Android 17.
+
+## SDK
+
+- Support Android 17.
+- Supported for the `ACCESS_LOCAL_NETWORK` permission, which becomes mandatory when targeting `targetSdkVersion 37`.
+
+stario (Ver. 2.14.3)<br>
+starioextension (Ver. 1.17.1)<br>
+StarIODeviceSetting (Ver. 1.0.5)
+
 # Ver.5.20.1 (2026/04/24)
 
 ## StarIO

Documents/CHANGELOG_JP.md

@@ -1,3 +1,27 @@
+# Ver.5.20.2 (2026/06/30)
+
+## StarIO
+
+- Android17に対応
+- `ACCESS_LOCAL_NETWORK`権限がないときのLAN通信にて、`searchPrinter` / `getPort` APIが適切な例外メッセージを出力するように変更
+
+## StarIOExtension
+
+- Android17に対応
+
+## StarIODeviceSetting
+
+- Android17に対応
+
+## SDK
+
+- Android17に対応
+- `targetSdkVersion 37`で必須化された`ACCESS_LOCAL_NETWORK`権限に対応
+
+stario (Ver. 2.14.3)<br>
+starioextension (Ver. 1.17.1)<br>
+StarIODeviceSetting (Ver. 1.0.5)
+
 # Ver.5.20.1 (2026/04/24)
 
 ## StarIO
@@ -7,7 +31,6 @@ stario (Ver. 2.14.2)<br>
 starioextension (Ver. 1.17.0)<br>
 StarIODeviceSetting (Ver. 1.0.4)
 
-
 # Ver 5.20.0 (2025/05/19)
 
 ## StarIO

Documents/README_JP.md

@@ -42,4 +42,4 @@ StarIOPort3.1.jar V2.6.0 (StarPRNT SDK V5.11.0)より、releasePortメソッド
 
 ## 著作権
 
-スター精密（株）Copyright 2016-2025
+スター精密（株）Copyright 2016-2026

Readme.md

@@ -42,4 +42,4 @@ Beginning from StarIOPort3.1.jar V2.6.0 (StarPRNT SDK V5.11.0), the releasePort
 
 ## Copyright
 
-Copyright 2016-2025 Star Micronics Co., Ltd. All rights reserved.
+Copyright 2016-2026 Star Micronics Co., Ltd. All rights reserved.

StarIODeviceSettingSDK/app/build.gradle

@@ -1,18 +1,17 @@
 plugins {
     id 'com.android.application'
-    id 'kotlin-android'
 }
 
 android {
     namespace "com.starmicronics.stariodevicesettingsdk"
-    compileSdk 36
+    compileSdk = 37
 
     defaultConfig {
         applicationId "com.starmicronics.stariodevicesettingsdk"
         minSdkVersion 24
-        targetSdkVersion 36
+        targetSdkVersion 37
         versionCode 1
-        versionName "1.0.4"
+        versionName "1.0.5"
 
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
     }
@@ -35,15 +34,12 @@ android {
 def coroutines_version = '1.6.4'
 
 dependencies {
-    implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:$coroutines_version"
-    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:$coroutines_version"
     implementation 'androidx.core:core-ktx:1.12.0'
     implementation 'androidx.appcompat:appcompat:1.7.0'
     implementation 'com.google.android.material:material:1.11.0'
     implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
-    implementation 'com.starmicronics:stario:2.14.2'
-    implementation 'com.starmicronics:stariodevicesetting:1.0.4'
+    implementation 'com.starmicronics:stario:2.14.3'
+    implementation 'com.starmicronics:stariodevicesetting:1.0.5'
     testImplementation 'junit:junit:'
     androidTestImplementation 'androidx.test.ext:junit:1.1.5'
     androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'

StarIODeviceSettingSDK/app/src/main/AndroidManifest.xml

@@ -13,6 +13,9 @@
         tools:targetApi="31" />
     <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
 
+    <uses-permission android:name="android.permission.ACCESS_LOCAL_NETWORK"
+        android:minSdkVersion="37" />
+
     <application
         android:allowBackup="true"
         android:icon="@mipmap/ic_launcher"

StarIODeviceSettingSDK/app/src/main/java/com/starmicronics/stariodevicesettingsdk/MainActivity.kt

@@ -7,11 +7,9 @@ import android.os.Build
 import android.os.Bundle
 import android.view.View
 import android.widget.Toast
-import androidx.annotation.RequiresApi
 import androidx.appcompat.app.AlertDialog
 import androidx.appcompat.app.AppCompatActivity
 import androidx.core.view.ViewCompat
-import androidx.core.view.WindowCompat
 import androidx.core.view.WindowInsetsCompat
 import androidx.core.view.updatePadding
 import com.starmicronics.stariodevicesetting.StarIODeviceSettingException
@@ -26,7 +24,7 @@ class MainActivity : AppCompatActivity() {
     private val scope = CoroutineScope(Dispatchers.Default + job)
 
     companion object {
-        private const val BLUETOOTH_REQUEST_CODE = 1000
+        private const val PERMISSIONS_REQUEST_CODE = 1000
     }
 
     private lateinit var binding: ActivityMainBinding
@@ -81,12 +79,14 @@ class MainActivity : AppCompatActivity() {
             }
         }
 
-        // If you are using Android 12 and targetSdkVersion is 31 or later,
+        // If you are using Android 12 or later and targetSdkVersion is 31 or later,
         // you have to request Bluetooth permission (Nearby devices permission) to use the Bluetooth printer.
         // https://developer.android.com/about/versions/12/features/bluetooth-permissions
-        if (Build.VERSION_CODES.S <= Build.VERSION.SDK_INT) {
-            requestBluetoothPermission()
-        }
+
+        // If you are using Android 17 or later and target SdkVersion is 37 or later,
+        // you have to request ACCESS_LOCAL_NETWORK permission to use the LAN printer.
+        // https://developer.android.com/privacy-and-security/local-network-permission
+        requestRuntimePermissions()
     }
 
     private suspend fun showResultDialog(message: String?) {
@@ -112,18 +112,29 @@ class MainActivity : AppCompatActivity() {
         return versionName
     }
 
-    @RequiresApi(31)
-    private fun requestBluetoothPermission() {
-        if (baseContext.checkSelfPermission(Manifest.permission.BLUETOOTH_CONNECT) == PackageManager.PERMISSION_DENIED ||
-            baseContext.checkSelfPermission(Manifest.permission.BLUETOOTH_SCAN) == PackageManager.PERMISSION_DENIED
-        ) {
-            requestPermissions(
-                arrayOf(
-                    Manifest.permission.BLUETOOTH_CONNECT,
-                    Manifest.permission.BLUETOOTH_SCAN
-                ),
-                BLUETOOTH_REQUEST_CODE
-            )
+    private fun requestRuntimePermissions() {
+        val permissions = mutableListOf<String>()
+
+        // Android 12 or later : Bluetooth
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+            if (applicationContext.checkSelfPermission(Manifest.permission.BLUETOOTH_CONNECT) == PackageManager.PERMISSION_DENIED) {
+                permissions.add(Manifest.permission.BLUETOOTH_CONNECT)
+            }
+
+            if (applicationContext.checkSelfPermission(Manifest.permission.BLUETOOTH_SCAN) == PackageManager.PERMISSION_DENIED) {
+                permissions.add(Manifest.permission.BLUETOOTH_SCAN)
+            }
+        }
+
+        // Android 17 or later : LAN
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.CINNAMON_BUN) {
+            if (applicationContext.checkSelfPermission(Manifest.permission.ACCESS_LOCAL_NETWORK) == PackageManager.PERMISSION_DENIED) {
+                permissions.add(Manifest.permission.ACCESS_LOCAL_NETWORK)
+            }
+        }
+
+        if (permissions.isNotEmpty()) {
+            requestPermissions(permissions.toTypedArray(), PERMISSIONS_REQUEST_CODE)
         }
     }
 
@@ -133,11 +144,18 @@ class MainActivity : AppCompatActivity() {
         grantResults: IntArray
     ) {
         super.onRequestPermissionsResult(requestCode, permissions, grantResults)
-        if (requestCode == BLUETOOTH_REQUEST_CODE) {
-            if (grantResults.size == 2 && grantResults[0] == PackageManager.PERMISSION_GRANTED && grantResults[1] == PackageManager.PERMISSION_GRANTED) {
-                // Bluetooth permissions are granted.
-            } else {
-                val text = "You have to allow \"Nearby devices\" to use the Bluetooth printer"
+        if (requestCode == PERMISSIONS_REQUEST_CODE) {
+            var allGranted = true
+
+            for (result in grantResults) {
+                if (result != PackageManager.PERMISSION_GRANTED) {
+                    allGranted = false
+                    break
+                }
+            }
+
+            if (!allGranted) {
+                val text = "You have to check permissions to use the LAN / Bluetooth printer"
                 Toast.makeText(baseContext, text, Toast.LENGTH_LONG).show()
             }
         }

StarIODeviceSettingSDK/build.gradle

@@ -1,13 +1,11 @@
 // Top-level build file where you can add configuration options common to all sub-projects/modules.
 buildscript {
-    ext.kotlin_version = "1.7.21"
     repositories {
         mavenCentral()
         google()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:8.9.0'
-        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+        classpath 'com.android.tools.build:gradle:9.2.1'
 
         // NOTE: Do not place your application dependencies here; they belong
         // in the individual module build.gradle files

StarIODeviceSettingSDK/gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
 #Fri Jan 05 11:32:57 JST 2024
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.11.1-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.4.1-bin.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists