UROVO ตัวอย่าง ScanManager Kotlin และรายการตรวจสอบความถูกต้อง

เตรียมพื้นฐาน SDK ที่ทำซ้ำได้

รวบรวมอาร์ติแฟกต์ SDK ที่ได้รับอนุมัติแล้วผ่านกระบวนการดาวน์โหลดของนักพัฒนาที่ได้รับการควบคุม บันทึกเวอร์ชันและ SHA-256 ควบคู่ไปกับบิลด์แอปพลิเคชันและบันทึกอุปกรณ์

เก็บ API ของผู้จำหน่ายไว้ด้านหลังอะแดปเตอร์สแกนเนอร์ เพื่อให้สามารถทดสอบหน่วยตรรกะทางธุรกิจได้โดยไม่ต้องใช้ฮาร์ดแวร์ และสามารถทดแทนการใช้งานการบันทึกอื่นได้

• อนุมัติแหล่งที่มา SDK เท่านั้น
• บันทึกแฮชของสิ่งประดิษฐ์แล้ว
• กำหนดขอบเขตของอะแดปเตอร์แล้ว
• สร้างเมทริกซ์อุปกรณ์แล้ว

เป็นเจ้าของวงจรการใช้งานเครื่องสแกนหนึ่งครั้ง

เอกสารอ้างอิง API อ้างอิง openScanner, closeScanner, startDecode, stopDecode และฟังก์ชันโหมดเอาต์พุต ตัดสินใจว่ากิจกรรม บริการเบื้องหน้า หรือส่วนประกอบขอบเขตแอปพลิเคชันอื่นเป็นเจ้าของการโทรเหล่านั้นหรือไม่

หลีกเลี่ยงการเปิดหน้าจอหลายหน้าจอโดยแยกจากกัน ทำให้การหยุดและปิดปลอดภัยในการทำซ้ำ และแสดงค่าที่ส่งคืนที่ล้มเหลวในสถานะการวินิจฉัยโดยไม่ต้องบันทึกน้ำหนักบรรทุกของบาร์โค้ด

• เจ้าของทรัพยากรรายเดียว
• การล้างข้อมูลแบบ Idempotent
• ส่งกลับค่าที่สังเกตได้
• ไม่มีเพย์โหลดในบันทึกธรรมดา

ตรวจสอบเพย์โหลดการออกอากาศ

การถ่ายทอดการถอดรหัสที่ประสบความสำเร็จอาจรวมถึงข้อมูลดิบ สตริงที่ถอดรหัส ความยาว และประเภทบาร์โค้ด ตรวจสอบการดำเนินการ ความเป็นโมฆะ และความยาวก่อนส่งมอบกิจกรรมโดเมน

เลือกตัวแทนที่เชื่อถือได้หนึ่งรายการ หากการเข้ารหัสมีความสำคัญ ให้คงไบต์ดิบไว้และถอดรหัสภายใต้ชุดอักขระที่ชัดเจน แทนที่จะถือว่าบาร์โค้ดทุกอันเป็นแบบ ASCII แบบธรรมดา

• การกระทำตรงกันทุกประการ
• ความยาวสอดคล้องกับน้ำหนักบรรทุก
• นโยบายการเข้ารหัสได้รับการจัดทำเป็นเอกสาร
• ตัวป้องกันเหตุการณ์ที่ซ้ำกัน

ย้ายจากการสาธิตไปสู่หลักฐานการใช้งานจริง

ความสำเร็จในการคอมไพล์พิสูจน์ให้เห็นถึงความเข้ากันได้ของแหล่งที่มาเท่านั้น รันแอปพลิเคชันบนรุ่น ระบบปฏิบัติการ และเฟิร์มแวร์ที่ต้องการแต่ละรุ่นพร้อมป้ายกำกับตัวแทนและสถานการณ์วงจรการใช้งาน

บันทึกการตั้งค่าเครื่องสแกนและโหมดเอาต์พุตหลังการกำหนดค่า การทดสอบการถดถอยหลังจากเฟิร์มแวร์ SDK แอปพลิเคชันหรือ MDM เปลี่ยนแปลงนโยบาย

• ตัวแทนการสแกนคลังข้อมูล
• เข้าสู่โหมดสลีปและทำต่อ
• กรณีรหัสที่รวดเร็วและยาว
• บันทึกการทดสอบเวอร์ชัน

ตัวอย่าง Kotlin ที่ทราบรอบการใช้งานน้อยที่สุด

ตรวจสอบค่าคงที่ของโหมดเอาต์พุต แฟล็กตัวรับ Android และความเป็นเจ้าของวงจรการใช้งานกับ SDK เป้าหมาย API และสถาปัตยกรรมแอปพลิเคชันที่แน่นอน

import android.content.BroadcastReceiver
import android.content.Context
import android.content.Intent
import android.content.IntentFilter
import android.device.ScanManager
import androidx.appcompat.app.AppCompatActivity

class UrovoScannerActivity : AppCompatActivity() {
    private val scanner = ScanManager()
    private var receiverRegistered = false

    private val decodeReceiver = object : BroadcastReceiver() {
        override fun onReceive(context: Context, intent: Intent) {
            if (intent.action != ScanManager.ACTION_DECODE) return
            val raw = intent.getByteArrayExtra(ScanManager.DECODE_DATA_TAG) ?: return
            val declaredLength = intent.getIntExtra(ScanManager.BARCODE_LENGTH_TAG, raw.size)
            val type = intent.getByteExtra(ScanManager.BARCODE_TYPE_TAG, 0)
            val value = intent.getStringExtra(ScanManager.BARCODE_STRING_TAG)
                ?: raw.copyOf(declaredLength.coerceIn(0, raw.size)).toString(Charsets.UTF_8)
            onValidatedScan(value, type)
        }
    }

    override fun onStart() {
        super.onStart()
        check(scanner.openScanner()) { "Scanner could not be opened" }
        // Confirm the broadcast-output constant in the SDK version you ship.
        check(scanner.switchOutputMode(0)) { "Output mode could not be set" }
        registerReceiver(decodeReceiver, IntentFilter(ScanManager.ACTION_DECODE))
        receiverRegistered = true
    }

    override fun onStop() {
        scanner.stopDecode()
        if (receiverRegistered) unregisterReceiver(decodeReceiver)
        receiverRegistered = false
        scanner.closeScanner()
        super.onStop()
    }

    private fun onValidatedScan(value: String, type: Byte) {
        // Route a sanitized domain event; do not log sensitive barcode values.
    }
}

รายการตรวจสอบการตรวจสอบ ScanManager

แนบบันทึกนี้กับแอปพลิเคชันและอุปกรณ์พื้นฐานที่ได้รับอนุมัติ

1. 01

   บันทึกเวอร์ชัน SDK และ SHA-256 แล้ว

2. 02

   อุปกรณ์ SKU, ระบบปฏิบัติการและเฟิร์มแวร์ที่บันทึกไว้

3. 03

   เครื่องสแกนเปิดและปิดซ้ำๆ

4. 04

   โหมดเอาต์พุตอ่านหรือยืนยันแล้ว

5. 05

   วงจรชีวิตของตัวรับตรงกับ UI ที่ใช้งานอยู่

6. 06

   ตรวจสอบค่าดิบ สตริง ความยาว และประเภทเพิ่มเติมแล้ว

7. 07

   ทดสอบสัญลักษณ์ที่จำเป็นทั้งหมดแล้ว

8. 08

   ทดสอบการสแกนที่ยาว เสียหาย และรวดเร็ว

9. 09

   ทดสอบโหมดสลีป รีบูต และ MDM แล้ว

10. 10

    ไม่มีการบันทึกข้อมูลบาร์โค้ดที่ละเอียดอ่อน

คำถามที่พบบ่อย