PlayIntegrityFork 项目使用教程

1. 项目介绍

PlayIntegrityFork 是一个开源项目，旨在修复 Android 设备上的 Play Integrity（以及 SafetyNet）验证问题。该项目通过注入 classes.dex 文件来修改 android.os.Build 类中的字段，并在原生代码中创建钩子以修改系统属性。这些修改仅针对 Google Play Services 的 DroidGuard 服务，目的是避免硬件认证。

PlayIntegrityFork 支持以下环境：

• Magisk with Zygisk enabled
• KernelSU with Zygisk Next module installed
• APatch with Zygisk Next module installed

2. 项目快速启动

2.1 安装依赖

确保你的设备已经安装了 Magisk 并且 Zygisk 已启用。如果没有安装 Magisk，请先安装 Magisk。

2.2 下载并安装 PlayIntegrityFork

1. 打开终端并克隆项目仓库：

   git clone https://github.com/osm0sis/PlayIntegrityFork.git
   

2. 进入项目目录：

   cd PlayIntegrityFork
   

3. 安装模块：

   ./install.sh
   

2.3 配置和使用

1. 创建 custom_pif.json 文件以自定义字段和属性。你可以参考项目中的 example_pif.json 文件。

2. 运行以下命令以应用配置：

   sh autopif.sh
   

3. 重启设备以使更改生效。

3. 应用案例和最佳实践

3.1 案例一：通过 Play Integrity 验证

假设你正在开发一个需要通过 Google Play Integrity 验证的应用。使用 PlayIntegrityFork 可以帮助你绕过硬件认证，确保应用在各种设备上都能通过验证。

3.2 案例二：测试环境搭建

在开发和测试阶段，你可能需要频繁地更改设备配置以测试不同的场景。PlayIntegrityFork 提供了灵活的配置选项，允许你快速切换不同的指纹和系统属性，从而简化测试流程。

3.3 最佳实践

• 定期更新模块：由于 Google 可能会更新其验证机制，建议定期更新 PlayIntegrityFork 模块以确保兼容性。
• 备份配置：在更改配置之前，建议备份当前的 custom_pif.json 文件，以便在需要时恢复。

4. 典型生态项目

4.1 Magisk

Magisk 是一个流行的 Android 系统修改工具，允许用户在不修改系统分区的情况下进行系统级别的修改。PlayIntegrityFork 依赖于 Magisk 的 Zygisk 功能来实现其功能。

4.2 KernelSU

KernelSU 是一个基于内核的系统修改工具，允许用户在 Android 设备上进行更深层次的系统修改。PlayIntegrityFork 支持 KernelSU 环境，提供了更广泛的设备兼容性。

4.3 APatch

APatch 是一个用于 Android 应用的补丁工具，允许开发者在不修改应用源代码的情况下进行功能增强。PlayIntegrityFork 支持 APatch 环境，为开发者提供了更多的灵活性。

通过这些生态项目的支持，PlayIntegrityFork 能够在不同的 Android 设备和环境中提供一致的 Play Integrity 修复功能。