跳到主要内容

安装

安装插件​

在 Flutter 项目根目录执行以下命令：

flutter pub add flutter_kyc_qitech

该命令会安装最新版本，并将依赖添加到 pubspec.yaml：

dependencies:
  flutter_kyc_qitech: ^5.3.0

然后拉取依赖：

flutter pub get

导入​

import 'package:flutter_kyc_qitech/flutter_kyc_qitech.dart';

并实例化插件：

final _qitechFlutterKycPlugin = FlutterKycQitech();

Android 配置​

1. QI Tech Maven 仓库​

在项目的 build.gradle 中添加 QI Tech 的 Android 仓库引用：

allprojects {
    repositories {
        maven { url 'https://sdks.qitech.com.br/' }
        ...
    }
}

2. AdMob​

在 AndroidManifest.xml 中添加以下代码以初始化 AdMob 服务：

<meta-data
    android:name="com.google.android.gms.ads.APPLICATION_ID"
    android:value="<ADMOB_APP_ID>"/>

如果您还没有 ADMOB_APP_ID，请联系 suporte.caas@qitech.com.br。

iOS 配置​

1. 相机权限​

在应用的 Info.plist 中添加 NSCameraUsageDescription 条目，说明应用需要访问相机的原因：

<key>NSCameraUsageDescription</key>
<string>我们需要使用相机拍摄您的证件照片</string>

2. QI Tech iOS 仓库 source​

在 Podfile 顶部添加以下 source：

source 'https://cdn.cocoapods.org/'
source 'https://github.com/QITechSDKs/iOS.git'

3. 静态 framework​

CocoaPods 默认构建静态库而非 framework。请在 Podfile 中添加：

use_frameworks! :linkage => :static

4. 模块稳定性​

QI Tech 的原生依赖要求为 Datadog 目标启用 BUILD_LIBRARY_FOR_DISTRIBUTION。请添加下面的 post_install 代码块（或合并到已有的 post_install 中）：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    target.build_configurations.each do |config|
      config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'NO'
      # 以下这行仅在模拟器上构建时需要（需启用 Rosetta）
      config.build_settings["EXCLUDED_ARCHS[sdk=iphonesimulator*]"] = "arm64"
    end
    if ['DatadogCore', 'DatadogInternal', 'DatadogCrashReporting', 'DatadogLogs'].include?(target.name)
      target.build_configurations.each do |config|
        config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '15.5'
        config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
      end
    end
  end
end

5. 安装 pod​

在 Flutter 应用的 ios 目录中执行：

cd ios
pod install

或通过 Flutter 执行：

flutter build ios
注意

如果您的应用已使用 Datadog，请使用 3.x 主版本中的最新版本（datadog_flutter_plugin 3.x）。如果使用 MLKit 的 FaceDetection，请使用 8.x 主版本中的最新版本。