PlayIntegrityFix模块化测试：单模块功能验证方法

1. 测试环境准备

1.1 基础环境要求

环境项	版本要求	验证命令
Android系统	8.0-15	getprop ro.build.version.sdk
模块化框架	Magisk 27.0+/KernelSU/APatch	magisk -v 或 ksud -v
Zygisk	启用状态	magisk --sqlite "SELECT value FROM settings WHERE key='zygisk';"

1.2 冲突模块检查

# 必须移除的冲突模块
CONFLICT_MODULES=("safetynet-fix" "MagiskHidePropsConf" "playcurl")
for module in "${CONFLICT_MODULES[@]}"; do
  if [ -d "/data/adb/modules/$module" ]; then
    echo "[!] 检测到冲突模块: $module"
    touch "/data/adb/modules/$module/remove"
  fi
done

2. 模块元数据验证

2.1 核心信息提取

# 从module.prop提取关键信息
grep -E 'id|name|version|author|description' module/module.prop

预期输出:

id=playintegrityfix
name=Play Integrity Fix
version=v19.1
author=chiteroman
description=Universal modular fix for Play Integrity (and SafetyNet) on devices running Android 8-15

2.2 配置文件结构验证

{
  "FINGERPRINT": "google/oriole_beta/oriole:16/BP22.250325.012/13467521:user/release-keys",
  "MANUFACTURER": "Google",
  "MODEL": "Pixel 6",
  "SECURITY_PATCH": "2025-04-05"
}

3. 核心功能测试流程

3.1 安装前置检查

flowchart TD
    A[开始安装] --> B{检查Boot模式}
    B -->|Recovery模式| C[终止并提示错误]
    B -->|正常模式| D{检查Android版本}
    D -->|API < 26| E[终止并提示不支持]
    D -->|API ≥ 26| F{检查Zygisk状态}
    F -->|未启用| G[终止并提示启用Zygisk]
    F -->|已启用| H[继续安装]

3.2 模块初始化验证

// EntryPoint.java核心初始化逻辑
public static void init(String json, boolean spoofProvider, boolean spoofSignature) {
    if (spoofProvider) spoofProvider();
    if (spoofSignature) spoofSignature();
    
    JSONObject jsonObject = new JSONObject(json);
    jsonObject.keys().forEachRemaining(key -> {
        Field field = getBuildField(key);
        if (field != null) map.put(field, jsonObject.getString(key));
    });
    spoofFields();
}

3.3 功能测试矩阵

3.3.1 设备指纹模拟测试

测试项	预期结果	验证方法
FINGERPRINT注入	系统属性被覆盖	getprop ro.build.fingerprint
安全补丁日期	与pif.json一致	getprop ro.build.version.security_patch
制造商信息	显示Google	getprop ro.product.manufacturer

3.3.2 依赖冲突处理测试

# customize.sh冲突模块检测逻辑
SNFix="/data/adb/modules/safetynet-fix"
if [ -d "$SNFix" ]; then
    ui_print "! safetynet-fix模块将在重启后移除"
    touch "$SNFix"/remove
fi

4. 关键功能验证步骤

4.1 Zygisk集成测试

# 验证Zygisk是否正常加载模块
adb shell "logcat | grep 'PIF: Parsed [0-9]* fields from JSON'"

4.2 属性修改持久化测试

1. 执行属性修改命令:

adb shell su -c "resetprop ro.debuggable 0"

2. 重启设备后验证:

adb shell getprop ro.debuggable  # 应返回0

4.3 动态指纹更新测试

# 触发action.sh自动更新逻辑
adb shell su -c "/data/adb/modules/playintegrityfix/action.sh"
# 验证新指纹是否生成
adb shell cat /data/adb/pif.json | grep FINGERPRINT

5. 故障排查与日志分析

5.1 常见错误日志解析

错误日志片段	可能原因	解决方案
Zygisk is not enabled	Zygisk未启用	在Magisk设置中开启Zygisk
fingerprint empty	pif.json生成失败	检查网络连接并重试
SELinux permission denied	权限配置错误	chmod 640 /sys/fs/selinux/enforce

5.2 测试结果判定标准

stateDiagram-v2
    [*] --> 初始状态
    初始状态 --> 环境检查: 开始测试
    环境检查 --> 依赖检查: 环境通过
    依赖检查 --> 功能测试: 依赖通过
    功能测试 --> 验证通过: 所有测试项通过
    功能测试 --> 验证失败: 存在未通过项
    验证失败 --> [*]: 修复问题后重试
    验证通过 --> [*]: 测试完成

6. 测试工具与资源

6.1 测试命令集合

功能	命令
查看模块版本	`adb shell cat /data/adb/modules/playintegrityfix/module.prop
强制刷新配置	adb shell su -c "killall com.google.android.gms.unstable"
查看属性列表	`adb shell getprop

6.2 测试报告模板

# PlayIntegrityFix测试报告
- 测试版本: v19.1
- 测试设备: Pixel 6 (Android 14)
- 测试结果: [通过/失败]
- 失败项: [如有请列出]
- 日志附件: [logcat片段]

7. 版本兼容性说明

Android版本	支持状态	特殊说明
8.0-12	完全支持	无需额外模块
13-15	需TrickyStore	需配合keybox使用

注意: Android 13+用户需额外安装TrickyStore模块以通过Device verdict
项目仓库: https://gitcode.com/GitHub_Trending/pl/PlayIntegrityFix

8. 测试流程总结

1. 环境准备阶段: 检查系统版本与依赖框架
2. 安装验证阶段: 确认模块正确加载无冲突
3. 功能测试阶段: 逐项验证指纹模拟、属性修改等核心功能
4. 兼容性测试: 在目标Android版本上重复验证
5. 压力测试: 连续重启5次验证持久化效果

通过以上测试流程，可确保PlayIntegrityFix模块在独立环境下的功能完整性与稳定性，为集成测试奠定基础。