Gradle 设置

rustls-platform-verifier 在包中捆绑了所需的本地组件，但项目必须设置为自动和正确地定位它们。以下步骤假设您正在使用 .gradle Groovy 文件，因为它们是最常见的，但所有内容 100% 适用于 Kotlin 脚本 (.gradle.kts) 配置，只需进行一些替换。

在您的项目的 build.gradle 文件中，添加以下代码和 Maven 仓库定义。如果适用，这应该是唯一一个“app”子项目，它将在运行时实际使用此包。如果多个项目同时运行此包，则您的 Gradle 配置性能可能会下降。

$PATH_TO_DEPENDENT_CRATE 是从 build.gradle 文件位置到任何依赖 rustls-platform-verifier 的包的 Cargo 清单文件 (Cargo.toml) 的相对路径。

import groovy.json.JsonSlurper

// ...Your own script code could be here...

repositories {
    // ... Your other repositories could be here...
    maven {
        url = findRustlsPlatformVerifierProject()
        metadataSources.artifact()
    }
}

String findRustlsPlatformVerifierProject() {
    def dependencyText = providers.exec {
        it.workingDir = new File("../")
        commandLine("cargo", "metadata", "--format-version", "1", "--manifest-path", "$PATH_TO_DEPENDENT_CRATE/Cargo.toml")
    }.standardOutput.asText.get()

    def dependencyJson = new JsonSlurper().parseText(dependencyText)
    def manifestPath = file(dependencyJson.packages.find { it.name == "rustls-platform-verifier-android" }.manifest_path)
    return new File(manifestPath.parentFile, "maven").path
}

然后，在您声明依赖项的地方，添加以下内容

implementation "rustls:rustls-platform-verifier:latest.release"

Cargo 会自动处理在您的项目中正确位置找到已下载的包。它还会处理在 rustls-platform-verifier 的新版本发布时更新版本。如果您只使用发布的版本，则不需要额外的维护。

这些脚本片段可以根据您的项目进行修改，但必须包含 cargo metadata 调用，以便在磁盘上定位 Android 实现部分。

Proguard

如果您的 Android 应用程序使用 Proguard 进行优化，请确保 Android 验证器组件没有被优化掉，因为它看起来像是死代码。Proguard 无法看到任何 JNI 使用，因此您必须手动将其包含在内。以下规则可以为您做到这一点

-keep, includedescriptorclasses class org.rustls.platformverifier.** { *; }

包初始化

为了让crate调用JVM，它需要来自Android的句柄。这些句柄由init_external或init_hosted函数提供。这些函数为rustls-platform-verifier提供所需的资源，以便调用Android证书验证器。

例如，如果您的Rust Android组件在启动时被“本地”Android应用程序部分调用，并且具有初始化，如下所示

#[export_name = "Java_com_orgname_android_rust_init"]
extern "C" fn java_init(
    env: JNIEnv,
    _class: JClass,
    context: JObject,
) -> jboolean {
    // ... initialize your app's other parts here.
}

在最简单的情况下，您应该在任何网络运行之前在这里插入对rustls_platform_verifier::android::init_hosted()的调用，这只需要调用一次，验证器将有效于应用程序进程的生命周期。

extern "C" fn java_init(
    env: JNIEnv,
    _class: JClass,
    context: JObject,
) -> jboolean {
    // ... initialize your app's other parts here.

    // Then, initialize the certificate verifier for future use.
    rustls_platform_verifier::android::init_hosted(&env, context);
}

在更复杂的情况下，例如，如果您的代码已经存储了长生命周期的句柄到Android环境中，您可以使用init_external作为替代。这个函数接受对实现android::Runtime特质的对象的&'static引用，crate随后使用这个引用在需要时获取对JVM的访问。

致谢

由1Password和rustls团队用❤️制作。Android和Windows的实现部分是从Chromium之前的验证器实现中改编和引用的。

许可证