Release 26.7.0 (#66)

Update the Android demo for Aspose.BarCode Cloud SDK 26.7.0.

Includes updated generation parameters, barcode rendering, progress animation, Android build tooling, and manifest settings.

Author: Denis-Averin

.gitignore

@@ -20,6 +20,9 @@ out/
 .gradle/
 build/
 
+# Daemon JVM criteria, generated locally by the updateDaemonJvm task
+gradle/gradle-daemon-jvm.properties
+
 # Local configuration file (sdk path, etc)
 local.properties
 

app/build.gradle

@@ -38,7 +38,7 @@ dependencies {
     implementation 'androidx.core:core-ktx:1.18.0'
     implementation 'androidx.appcompat:appcompat:1.7.1'
     implementation 'androidx.constraintlayout:constraintlayout:2.2.1'
-    implementation 'com.aspose:aspose-barcode-cloud:26.6.0'
+    implementation 'com.aspose:aspose-barcode-cloud:26.7.0'
     implementation 'com.google.android.material:material:1.13.0'
     testImplementation 'junit:junit:4.13.2'
     androidTestImplementation 'androidx.test.ext:junit:1.3.0'

app/src/main/AndroidManifest.xml

@@ -11,6 +11,7 @@
 
     <application
         android:allowBackup="true"
+        android:dataExtractionRules="@xml/data_extraction_rules"
         android:fullBackupContent="@xml/backup_descriptor"
         android:icon="@mipmap/ic_launcher"
         android:label="@string/app_name"

app/src/main/java/com/aspose/barcode/cloud/demo_app/MainActivity.kt

@@ -54,21 +54,37 @@ import com.aspose.barcode.cloud.api.GenerateApi
 import com.aspose.barcode.cloud.api.ScanApi
 import com.aspose.barcode.cloud.model.BarcodeImageFormat
 import com.aspose.barcode.cloud.model.BarcodeImageParams
+import com.aspose.barcode.cloud.model.Code128EncodeMode
+import com.aspose.barcode.cloud.model.Code128Params
+import com.aspose.barcode.cloud.model.ECIEncodings
 import com.aspose.barcode.cloud.model.EncodeBarcodeType
+import com.aspose.barcode.cloud.model.MicroQRVersion
+import com.aspose.barcode.cloud.model.Pdf417EncodeMode
+import com.aspose.barcode.cloud.model.Pdf417ErrorLevel
+import com.aspose.barcode.cloud.model.Pdf417Params
 import com.aspose.barcode.cloud.model.QREncodeMode
 import com.aspose.barcode.cloud.model.QRErrorLevel
 import com.aspose.barcode.cloud.model.QRVersion
 import com.aspose.barcode.cloud.model.QrParams
+import com.aspose.barcode.cloud.model.RectMicroQRVersion
 import com.aspose.barcode.cloud.requests.GenerateRequestWrapper
 import com.aspose.barcode.cloud.requests.ScanMultipartRequestWrapper
 import com.google.android.material.snackbar.Snackbar
 import java.io.File
 import java.io.FileOutputStream
 import kotlin.math.floor
+import kotlin.math.min
 import androidx.core.graphics.scale
 
 class MainActivity : AppCompatActivity() {
     companion object {
+        /** Barcode types whose modules are square and get distorted by a non-square image. */
+        private val SQUARE_BARCODE_TYPES = setOf(
+            EncodeBarcodeType.QR,
+            EncodeBarcodeType.GS1_QR,
+            EncodeBarcodeType.MICRO_QR,
+        )
+
         private fun imageSize(width: Int, height: Int, maxSize: Int = 384): Size {
             val ratio = width.toFloat() / height
             if (ratio > 1) {
@@ -194,7 +210,7 @@ class MainActivity : AppCompatActivity() {
             val smallerBmp = reduceBitmapSize(image)
 
             barcodeImgView.setImageBitmap(smallerBmp)
-            startRecognizeAnimation()
+            startProgressAnimation()
 
             val tmpFile = File.createTempFile("barcode", null)
 
@@ -209,7 +225,7 @@ class MainActivity : AppCompatActivity() {
                     val recognized = scanApi.scanMultipart(apiRequest)
 
                     runOnUiThread {
-                        stopRecognizeAnimation()
+                        stopProgressAnimation()
                         if (recognized.barcodes.isEmpty()) {
                             barcodeTextEdit.setText("")
                             showErrorMessage("No barcode detected")
@@ -222,7 +238,7 @@ class MainActivity : AppCompatActivity() {
                     }
                 } catch (e: ApiException) {
                     runOnUiThread {
-                        stopRecognizeAnimation()
+                        stopProgressAnimation()
 
                         var message = e.message + ": " + e.details
                         if (e.httpCode == 0) {
@@ -232,7 +248,7 @@ class MainActivity : AppCompatActivity() {
                     }
                 } catch (e: Exception) {
                     runOnUiThread {
-                        stopRecognizeAnimation()
+                        stopProgressAnimation()
                         showErrorMessage("Exception: " + e.message)
                     }
                 }
@@ -242,44 +258,38 @@ class MainActivity : AppCompatActivity() {
         }
     }
 
-    private fun startRecognizeAnimation() {
+    private fun startProgressAnimation() {
         val rotation = AnimationUtils.loadAnimation(this, R.anim.rotate)
         rotation.fillAfter = true
         barcodeImgView.startAnimation(rotation)
     }
 
-    private fun stopRecognizeAnimation() {
+    private fun stopProgressAnimation() {
         barcodeImgView.clearAnimation()
     }
 
     fun onBtnGenerateClick(@Suppress("UNUSED_PARAMETER") view: View) {
         val type = EncodeBarcodeType.fromValue(barcodeTypeSpinner.selectedItem.toString())
 
         val genRequest = GenerateRequestWrapper(type, barcodeTextEdit.text.toString())
-        genRequest.barcodeImageParams = BarcodeImageParams().apply {
-            imageFormat = BarcodeImageFormat.PNG
-            imageHeight = barcodeImgView.measuredHeight.toFloat()
-            imageWidth = barcodeImgView.measuredWidth.toFloat()
-        }
+        genRequest.barcodeImageParams = imageParams(type)
 
-        if (type == EncodeBarcodeType.QR) {
-            genRequest.qrParams = QrParams().apply {
-                qrEncodeMode = QREncodeMode.AUTO
-                qrErrorLevel = QRErrorLevel.LEVEL_M
-                qrVersion = QRVersion.AUTO
-                qrAspectRatio = 0.75f
-            }
-        }
+        applyEncodeParams(genRequest, type)
+
+        startProgressAnimation()
 
         Thread {
             try {
                 val generated = generateApi.generate(genRequest)
                 runOnUiThread {
+                    stopProgressAnimation()
                     val bitmap = BitmapFactory.decodeFile(generated!!.absolutePath)
                     barcodeImgView.setImageBitmap(bitmap)
                 }
             } catch (e: ApiException) {
                 runOnUiThread {
+                    stopProgressAnimation()
+
                     var message = e.message + ": " + e.details
                     if (e.httpCode == 0) {
                         message = "Check ClientId and ClientSecret in ApiClient $message"
@@ -288,12 +298,85 @@ class MainActivity : AppCompatActivity() {
                 }
             } catch (e: Exception) {
                 runOnUiThread {
+                    stopProgressAnimation()
                     showErrorMessage("Exception: " + e.message)
                 }
             }
         }.start()
     }
 
+    /**
+     * The API stretches the barcode to fill the requested image, so a square symbology
+     * has to be rendered into a square image to keep its modules square.
+     */
+    private fun imageParams(type: EncodeBarcodeType) = BarcodeImageParams().apply {
+        imageFormat = BarcodeImageFormat.PNG
+
+        if (type in SQUARE_BARCODE_TYPES) {
+            val side = min(barcodeImgView.measuredWidth, barcodeImgView.measuredHeight).toFloat()
+            imageHeight = side
+            imageWidth = side
+        } else {
+            imageHeight = barcodeImgView.measuredHeight.toFloat()
+            imageWidth = barcodeImgView.measuredWidth.toFloat()
+        }
+    }
+
+    /**
+     * Attaches the optional parameter groups supported by [GenerateRequestWrapper].
+     * Each group applies to its own family of barcode types.
+     */
+    private fun applyEncodeParams(request: GenerateRequestWrapper, type: EncodeBarcodeType) {
+        when (type) {
+            EncodeBarcodeType.QR,
+            EncodeBarcodeType.GS1_QR -> request.qrParams = qrParams()
+
+            EncodeBarcodeType.MICRO_QR -> request.qrParams = qrParams().apply {
+                microQRVersion = MicroQRVersion.AUTO
+            }
+
+            EncodeBarcodeType.RECT_MICRO_QR -> request.qrParams = qrParams().apply {
+                rectMicroQrVersion = RectMicroQRVersion.AUTO
+            }
+
+            EncodeBarcodeType.CODE128,
+            EncodeBarcodeType.GS1_CODE128 -> request.code128Params = Code128Params().apply {
+                code128EncodeMode = Code128EncodeMode.AUTO
+            }
+
+            EncodeBarcodeType.PDF417,
+            EncodeBarcodeType.MACRO_PDF417 -> request.pdf417Params = pdf417Params(3.0f)
+
+            EncodeBarcodeType.MICRO_PDF417,
+            EncodeBarcodeType.GS1_MICRO_PDF417 -> request.pdf417Params = pdf417Params(2.0f)
+
+            else -> Unit
+        }
+    }
+
+    private fun qrParams() = QrParams().apply {
+        qrEncodeMode = QREncodeMode.AUTO
+        qrErrorLevel = QRErrorLevel.LEVEL_M
+        qrVersion = QRVersion.AUTO
+        qrECIEncoding = ECIEncodings.UTF8
+        // 1.0 keeps the modules square, lower values flatten the barcode.
+        qrAspectRatio = 1.0f
+    }
+
+    /**
+     * @param aspectRatio defined by the standard: 3 to 5 for Pdf417 and MacroPdf417,
+     * 2 to 5 for MicroPdf417.
+     */
+    private fun pdf417Params(aspectRatio: Float) = Pdf417Params().apply {
+        pdf417EncodeMode = Pdf417EncodeMode.AUTO
+        pdf417ErrorLevel = Pdf417ErrorLevel.LEVEL2
+        pdf417ECIEncoding = ECIEncodings.UTF8
+        pdf417AspectRatio = aspectRatio
+        // 0 selects the column and row count automatically.
+        pdf417Columns = 0
+        pdf417Rows = 0
+    }
+
     fun onBtnTakePhotoClick(@Suppress("UNUSED_PARAMETER") view: View) {
         val takePictureIntent = Intent(MediaStore.ACTION_IMAGE_CAPTURE)
         if (takePictureIntent.resolveActivity(packageManager) != null) {

app/src/main/res/xml/backup_rules.xml

@@ -1,5 +1,5 @@
 // Top-level build file where you can add configuration options common to all sub-projects/modules.
 plugins {
-    id 'com.android.application' version '9.1.0' apply false
-    id 'com.android.library' version '9.1.0' apply false
+    id 'com.android.application' version '9.3.1' apply false
+    id 'com.android.library' version '9.3.1' apply false
 }

build.gradle

@@ -1,6 +1,6 @@
 #Fri Jan 27 19:13:42 YEKT 2023
 distributionBase=GRADLE_USER_HOME
-distributionUrl=https\://services.gradle.org/distributions/gradle-9.3.1-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.5.0-bin.zip
 distributionPath=wrapper/dists
 zipStorePath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME

gradle/wrapper/gradle-wrapper.properties

@@ -16,7 +16,7 @@ pushd "${SCRIPT_DIR}/.." >/dev/null
     fi
 done
 
-(grep -oP '[^/]+\.yml/badge.svg(?!\?branch=main)' "${readme_file}" || echo ) | while read -r badge_without_branch; do
+(grep -oP '[^/]+\.yml/badge.svg(?!\?branch=(main|v4)\b)' "${readme_file}" || echo ) | while read -r badge_without_branch; do
     if [ -z "${badge_without_branch}" ]; then continue; fi
     >&2 echo "Badge without branch \"${badge_without_branch}\""
     exit 1