Android 扫码 - 集成华为统一扫码服务

最新推荐文章于 2025-04-23 00:15:00 发布

我命由我12345

最新推荐文章于 2025-04-23 00:15:00 发布

阅读量916

点赞数 19

分类专栏： Android - 简化库编程文章标签： android 华为 java 开发语言 android-studio android studio java-ee

本文链接：https://blog.youkuaiyun.com/weixin_52173250/article/details/146366231

版权

Android - 简化库编程专栏收录该内容

10 篇文章

订阅专栏

一、概述

统一扫码服务（Scan Kit）提供便捷的条形码和二维码扫描、解析、生成能力，快速构建应用内的扫码功能
得益于华为在计算机视觉领域能力的积累，Scan Kit 可以实现远距离码或小型码的检测和自动放大，同时针对常见复杂扫码场景（如反光、暗光、污损、模糊、柱面）做了针对性识别优化，提升扫码成功率与用户体验
官方网址：https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-integrating-sdk-0000001050042006

二、集成统一扫码服务

1、配置 AppGallery Connect

见官方网址：https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-config-agc-0000001050043955
AppGallery Connect 官网：https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/

2、集成 HMS Core SDK

（1）添加当前应用的 AppGallery Connect 配置文件

见官方网址：https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-integrating-sdk-0000001050042006

（2）配置 HMS Core SDK 的 Maven 仓地址

此处针对 Gradle 7.1 及以上版本

项目级 build.gradle 文件

buildscript {
    ...

    dependencies {
        ...

        classpath 'com.android.tools.build:gradle:7.2.2' // Gradle 插件版本号配置
        classpath 'com.huawei.agconnect:agcp:1.6.0.300' // AGC 插件配置
    }
}

项目级 settings.gradle 文件

pluginManagement {
    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()

        // 配置 HMS Core SDK 的 Maven 仓地址
        maven { url 'https://developer.huawei.com/repo/' }
    }
}
dependencyResolutionManagement {
    ...

    repositories {
        google()
        mavenCentral()

        // 配置 HMS Core SDK 的 Maven 仓地址
        maven { url 'https://developer.huawei.com/repo/' }
    }
}

3、添加编译依赖

（1）添加步骤

模块级 build.gradle 文件

plugins {
    id 'com.android.application'
    
    // 添加 AGC 插件配置
    id 'com.huawei.agconnect'
}

...

dependencies {
    ...

//    implementation 'com.huawei.hms:scan:2.9.0.300' // 适用于对 SDK大小敏感的开发者
    implementation 'com.huawei.hms:scanplus:2.9.0.300' // 适用于对 SDK 大小不敏感且希望所有机型均具备最佳体验的开发者

}

（2）常见异常

Could not find method android() for arguments [build_3544eiqvy9xofe76nncvutqxl$_run_closure1@42da34b1] on project ':huaweiscan' of type org.gradle.api.Project.

缺少了 com.android.application，采用如下任意一种方式添加即可

plugins {
   id 'com.android.application'
   id 'com.huawei.agconnect'
}

apply plugin: 'com.android.application'
apply plugin: 'com.huawei.agconnect'

4、配置混淆脚本

应用级根目录下 proguard-rules.pro

-ignorewarnings
-keepattributes *Annotation*
-keepattributes Exceptions
-keepattributes InnerClasses
-keepattributes Signature
-keepattributes SourceFile,LineNumberTable
-keep class com.huawei.hianalytics.**{*;}
-keep class com.huawei.updatesdk.**{*;}
-keep class com.huawei.hms.**{*;}

5、权限配置

AndroidManifest.xml

<!-- 相机权限 -->
<uses-permission android:name="android.permission.CAMERA" />
<!-- 文件读取权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

注：该权限还需要在代码中动态申请

三、使用统一扫码服务

1、XML 文件

activity_start_scan.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="5dp"
    android:orientation="vertical">

    <Button
        android:id="@+id/btn_start_scan"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginBottom="5dp"
        android:textSize="17dp"
        android:text="扫描二维码" />

    <TextView
        android:id="@+id/tv_scan_result"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:textSize="17dp" />
</LinearLayout>

2、Java 代码

StartScanActivity.java

package com.my.huaweiscan;

import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.annotation.RequiresApi;
import androidx.appcompat.app.AppCompatActivity;

import android.Manifest;
import android.content.Intent;
import android.content.pm.PackageManager;
import android.os.Build;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;
import android.widget.Toast;

public class StartScanActivity extends AppCompatActivity implements View.OnClickListener {
    private static final String[] PERMISSIONS = new String[] {
            Manifest.permission.CAMERA,
            Manifest.permission.READ_EXTERNAL_STORAGE
    };

    private static final int REQUEST_CODE_SCAN_ONE = 1;
    private static final int CAMERA_REQ_CODE = 100;
    private static boolean scanFlag = false;

    private TextView tv_scan_result;

    @RequiresApi(api = Build.VERSION_CODES.M)
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_start_scan);

        // 动态申请权限
        requestPermissions(
                new String[]{Manifest.permission.CAMERA, Manifest.permission.READ_EXTERNAL_STORAGE},
                CAMERA_REQ_CODE);

        Button btn_start_scan = findViewById(R.id.btn_start_scan);
        tv_scan_result = findViewById(R.id.tv_scan_result);

        btn_start_scan.setOnClickListener(this);
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);

        // 判断 requestCode 是否为申请权限时设置请求码 CAMERA_REQ_CODE，然后校验权限开启状态
        if (requestCode == CAMERA_REQ_CODE && grantResults.length == PERMISSIONS.length
                && grantResults[0] == PackageManager.PERMISSION_GRANTED
                && grantResults[1] == PackageManager.PERMISSION_GRANTED) {
            scanFlag = true;
        }
    }

    @Override
    public void onClick(View v) {
        if (scanFlag) {
            defaultViewModeScan();
        } else {
            Toast.makeText(this, "未开启相关权限", Toast.LENGTH_SHORT).show();
        }
    }

    // 开启扫码
    private void defaultViewModeScan() {

        // QRCODE_SCAN_TYPE 和 DATAMATRIX_SCAN_TYPE 表示只扫描 QR 和 DataMatrix 码
        // setViewType 设置扫码标题
        //      0 表示设置扫码标题为”扫描二维码 / 条码“（默认）
        //      1 表示设置扫码标题为”扫描二维码“
        HmsScanAnalyzerOptions options = new HmsScanAnalyzerOptions.Creator()
                .setHmsScanTypes(HmsScan.QRCODE_SCAN_TYPE, HmsScan.DATAMATRIX_SCAN_TYPE)
                .setViewType(1)
                .create();
        ScanUtil.startScan(this, REQUEST_CODE_SCAN_ONE, options);
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
        super.onActivityResult(requestCode, resultCode, data);

        if (resultCode != RESULT_OK || data == null) {
            return;
        }

        if (requestCode == REQUEST_CODE_SCAN_ONE) {

            // 导入图片扫描返回结果
            HmsScan obj = data.getParcelableExtra(ScanUtil.RESULT);
            if (obj != null) {

                // 展示解码结果
                showResult(obj);
            }
        }
    }

    private void showResult(HmsScan obj) {
        String value = obj.getOriginalValue();
        tv_scan_result.setText("扫描结果：" + value);
    }
}