@harmonyos-arkts/d2h 0.1.10 → 0.1.12

package/skills/d2h-hypium-forge/scripts/precondition.py

@@ -1,140 +1,140 @@
-#!/usr/bin/env python3
-"""
-precondition.py — 测试前置自动化：权限预授 + 登录/账号策略 + 首启弹窗处理。
-
-原则（项目经验 2）:
-  所有权限和账号默认优先完成确认/登录；无法自动完成的，生成明确的用户提醒清单
-  （而非留到用例执行中反复失败）。
-
-动作:
-  1. 解析 module.json5 权限 → hdc pm grant 预授（按 ACL 级别分类:
-     normal/system_basic → 尝试预授；user_grant 运行时权限 → 模拟器上多数可 grant）
-  2. 登录页检测 → 三级策略:
-     a. mock 登录入口（源码含"模拟登录"）→ 自动用之
-     b. UI 自动化登录（已知测试账号）→ 提醒用户提供或用环境变量
-     c. 不可自动 → 用户提醒清单
-  3. 首启弹窗预处置（隐私协议/权限弹窗）→ 输出 dismiss 脚本片段
-
-用法:
-  precondition.py --features features.json --device 127.0.0.1:5555 [--user-account-env HM_TEST_ACCOUNT]
-输出: preconditions.md（执行结果 + 用户提醒清单）
-"""
-import argparse
-import json
-import os
-import re
-import subprocess
-import sys
-
-HDC = '/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc'
-
-# 鸿蒙权限 → 授予难度（默认可 grant / 需弹窗确认 / 系统级不可授）
-GRANTABLE = re.compile(r'ohos\.permission\.(INTERNET|GET_NETWORK_INFO|KEEP_BACKGROUND_RUNNING|'
-                       r'REQUIRE_FORM|PUBLISH_AGENT_REMINDER|VIBRATE|QUERY_AUDIO_DEVICE_STATE)')
-# 运行时弹窗类（模拟器可 pm grant）
-RUNTIME = re.compile(r'ohos\.permission\.(READ_|WRITE_|MICROPHONE|CAMERA|LOCATION|MEDIA|'
-                     r'APPTRACKING|CALENDAR|CONTACTS|DISTRIBUTED)')
-# 用户身份类（不可自动，需用户操作）
-USER_IDENTITY = re.compile(r'ohos\.permission\.(USER_AUTH|MANAGE_FINGERPRINT|ACCESS_USER_AUTH|'
-                           r'SECURE_SESSION|READ_HEALTH|SPORT)')
-
-
-def hdc(device, *args, capture=True):
-    cmd = [HDC, '-t', device] + list(args)
-    try:
-        r = subprocess.run(cmd, capture_output=capture, text=True, timeout=30)
-        return (r.stdout or '') + (r.stderr or '')
-    except Exception as e:
-        return f'ERROR: {e}'
-
-
-def main():
-    ap = argparse.ArgumentParser()
-    ap.add_argument('--features', required=True)
-    ap.add_argument('--device', default='127.0.0.1:5555')
-    ap.add_argument('--bundle', default=None)
-    ap.add_argument('--test-account-env', default='HM_TEST_ACCOUNT',
-                    help='测试账号环境变量名（格式 user:pass）')
-    args = ap.parse_args()
-
-    feats = json.load(open(args.features, encoding='utf-8'))
-    bundle = args.bundle or feats.get('bundle')
-    if not bundle:
-        print('错误: 无法确定 bundleName', file=sys.stderr)
-        sys.exit(1)
-
-    report = [f'# 测试前置报告（{bundle} @ {args.device}）', '']
-    reminders = []
-
-    # ── 1. 权限预授 ──
-    report.append('## 权限预授')
-    ok, skipped, user_confirm = [], [], []
-    for perm in feats.get('permissions', []):
-        if USER_IDENTITY.search(perm):
-            user_confirm.append(perm)
-            continue
-        if GRANTABLE.search(perm) or RUNTIME.search(perm):
-            out = hdc(args.device, 'shell', 'atm', 'perm', '-g', bundle, perm)
-            granted = 'grant' in out.lower() and 'fail' not in out.lower()
-            if not granted:
-                out2 = hdc(args.device, 'shell', f'pm grant {bundle} {perm}')
-                granted = 'fail' not in out2.lower() and 'Exception' not in out2
-            (ok if granted else skipped).append(perm)
-        else:
-            skipped.append(perm)
-    report.append(f'- 已预授 {len(ok)}: {", ".join(ok) or "无"}')
-    if skipped:
-        report.append(f'- 跳过 {len(skipped)}（授予失败或需特殊签名）: {", ".join(skipped)}')
-    if user_confirm:
-        report.append(f'- 需用户在设备上确认: {", ".join(user_confirm)}')
-        reminders.append(f'身份类权限需手动确认: {", ".join(user_confirm)}')
-    report.append('')
-
-    # ── 2. 登录策略（用户 2026-09-27 指正：不能止步于标 BLOCKED，必须提醒用户三选一）──
-    report.append('## 登录/账号策略')
-    if feats.get('has_login'):
-        acct = os.environ.get(args.test_account_env, '')
-        if acct:
-            report.append(f'- 检测到登录页；使用环境变量 {args.test_account_env} 提供的测试账号（自动登录用例将启用）')
-        else:
-            report.append('- 检测到登录页；**未设置测试账号（export '
-                          f'{args.test_account_env}=user:pass）**。登录域用例暂标 BLOCKED，'
-                          '**请从以下三种方式选择其一解除**：')
-            report.append('  1. **手动登录**：在模拟器/真机上人工完成一次登录（登录态持久，最真实，'
-                          '适合无需反复切换账号的场景）——完成后告知，BLOCKED 用例即可重跑；')
-            report.append('  2. **提供账号密码**：给出测试账号，构造登录用例（输入账号密码→提交→断言登录成功），'
-                          '登录链路本身也被覆盖——需 export 环境变量或直接告知；')
-            report.append('  3. **mock 登录态**：修改代码伪造已登录状态（如 userName 直接赋值）——'
-                          '**注意：这不是真实功能状态**，仅解锁被门禁的功能验证（hn-android FS-41 先例），'
-                          '需在用例/代码注释标明，且登录链路本身仍属未覆盖。')
-            reminders.append('登录域用例 BLOCKED 待解除：手动登录设备 / 提供测试账号 / mock 登录态（三选一，见 preconditions.md）')
-    else:
-        report.append('- 未检测到登录页，无需账号')
-    report.append('')
-
-    # ── 3. 首启弹窗预处置 ──
-    report.append('## 首启弹窗预处置（自动 dismiss 片段，注入 _common.launch）')
-    report.append('```python')
-    report.append('# 常见首启弹窗一键处理（在 launch 后 sleep 1 时执行）')
-    report.append('for txt in ["同意并继续", "允许", "我知道了", "暂不", "以后再说"]:')
-    report.append('    try:')
-    report.append('        c = d.find_component(BY.text(txt))')
-    report.append('        if c: c.click(); time.sleep(0.8)')
-    report.append('    except Exception: pass')
-    report.append('```')
-    report.append('')
-
-    if reminders:
-        report += ['## ⚠️ 用户提醒清单', *[f'- {r}' for r in reminders], '']
-    else:
-        report.append('## 用户提醒清单: 无（全部前置已自动完成）')
-
-    out_md = os.path.join(os.path.dirname(os.path.abspath(args.features)),
-                          'preconditions.md')
-    open(out_md, 'w', encoding='utf-8').write('\n'.join(report))
-    print('\n'.join(report))
-    print(f'\n报告: {out_md}')
-
-
-if __name__ == '__main__':
-    main()
+#!/usr/bin/env python3
+"""
+precondition.py — 测试前置自动化：权限预授 + 登录/账号策略 + 首启弹窗处理。
+
+原则（项目经验 2）:
+  所有权限和账号默认优先完成确认/登录；无法自动完成的，生成明确的用户提醒清单
+  （而非留到用例执行中反复失败）。
+
+动作:
+  1. 解析 module.json5 权限 → hdc pm grant 预授（按 ACL 级别分类:
+     normal/system_basic → 尝试预授；user_grant 运行时权限 → 模拟器上多数可 grant）
+  2. 登录页检测 → 三级策略:
+     a. mock 登录入口（源码含"模拟登录"）→ 自动用之
+     b. UI 自动化登录（已知测试账号）→ 提醒用户提供或用环境变量
+     c. 不可自动 → 用户提醒清单
+  3. 首启弹窗预处置（隐私协议/权限弹窗）→ 输出 dismiss 脚本片段
+
+用法:
+  precondition.py --features features.json --device 127.0.0.1:5555 [--user-account-env HM_TEST_ACCOUNT]
+输出: preconditions.md（执行结果 + 用户提醒清单）
+"""
+import argparse
+import json
+import os
+import re
+import subprocess
+import sys
+
+HDC = '/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc'
+
+# 鸿蒙权限 → 授予难度（默认可 grant / 需弹窗确认 / 系统级不可授）
+GRANTABLE = re.compile(r'ohos\.permission\.(INTERNET|GET_NETWORK_INFO|KEEP_BACKGROUND_RUNNING|'
+                       r'REQUIRE_FORM|PUBLISH_AGENT_REMINDER|VIBRATE|QUERY_AUDIO_DEVICE_STATE)')
+# 运行时弹窗类（模拟器可 pm grant）
+RUNTIME = re.compile(r'ohos\.permission\.(READ_|WRITE_|MICROPHONE|CAMERA|LOCATION|MEDIA|'
+                     r'APPTRACKING|CALENDAR|CONTACTS|DISTRIBUTED)')
+# 用户身份类（不可自动，需用户操作）
+USER_IDENTITY = re.compile(r'ohos\.permission\.(USER_AUTH|MANAGE_FINGERPRINT|ACCESS_USER_AUTH|'
+                           r'SECURE_SESSION|READ_HEALTH|SPORT)')
+
+
+def hdc(device, *args, capture=True):
+    cmd = [HDC, '-t', device] + list(args)
+    try:
+        r = subprocess.run(cmd, capture_output=capture, text=True, timeout=30)
+        return (r.stdout or '') + (r.stderr or '')
+    except Exception as e:
+        return f'ERROR: {e}'
+
+
+def main():
+    ap = argparse.ArgumentParser()
+    ap.add_argument('--features', required=True)
+    ap.add_argument('--device', default='127.0.0.1:5555')
+    ap.add_argument('--bundle', default=None)
+    ap.add_argument('--test-account-env', default='HM_TEST_ACCOUNT',
+                    help='测试账号环境变量名（格式 user:pass）')
+    args = ap.parse_args()
+
+    feats = json.load(open(args.features, encoding='utf-8'))
+    bundle = args.bundle or feats.get('bundle')
+    if not bundle:
+        print('错误: 无法确定 bundleName', file=sys.stderr)
+        sys.exit(1)
+
+    report = [f'# 测试前置报告（{bundle} @ {args.device}）', '']
+    reminders = []
+
+    # ── 1. 权限预授 ──
+    report.append('## 权限预授')
+    ok, skipped, user_confirm = [], [], []
+    for perm in feats.get('permissions', []):
+        if USER_IDENTITY.search(perm):
+            user_confirm.append(perm)
+            continue
+        if GRANTABLE.search(perm) or RUNTIME.search(perm):
+            out = hdc(args.device, 'shell', 'atm', 'perm', '-g', bundle, perm)
+            granted = 'grant' in out.lower() and 'fail' not in out.lower()
+            if not granted:
+                out2 = hdc(args.device, 'shell', f'pm grant {bundle} {perm}')
+                granted = 'fail' not in out2.lower() and 'Exception' not in out2
+            (ok if granted else skipped).append(perm)
+        else:
+            skipped.append(perm)
+    report.append(f'- 已预授 {len(ok)}: {", ".join(ok) or "无"}')
+    if skipped:
+        report.append(f'- 跳过 {len(skipped)}（授予失败或需特殊签名）: {", ".join(skipped)}')
+    if user_confirm:
+        report.append(f'- 需用户在设备上确认: {", ".join(user_confirm)}')
+        reminders.append(f'身份类权限需手动确认: {", ".join(user_confirm)}')
+    report.append('')
+
+    # ── 2. 登录策略（用户 2026-09-27 指正：不能止步于标 BLOCKED，必须提醒用户三选一）──
+    report.append('## 登录/账号策略')
+    if feats.get('has_login'):
+        acct = os.environ.get(args.test_account_env, '')
+        if acct:
+            report.append(f'- 检测到登录页；使用环境变量 {args.test_account_env} 提供的测试账号（自动登录用例将启用）')
+        else:
+            report.append('- 检测到登录页；**未设置测试账号（export '
+                          f'{args.test_account_env}=user:pass）**。登录域用例暂标 BLOCKED，'
+                          '**请从以下三种方式选择其一解除**：')
+            report.append('  1. **手动登录**：在模拟器/真机上人工完成一次登录（登录态持久，最真实，'
+                          '适合无需反复切换账号的场景）——完成后告知，BLOCKED 用例即可重跑；')
+            report.append('  2. **提供账号密码**：给出测试账号，构造登录用例（输入账号密码→提交→断言登录成功），'
+                          '登录链路本身也被覆盖——需 export 环境变量或直接告知；')
+            report.append('  3. **mock 登录态**：修改代码伪造已登录状态（如 userName 直接赋值）——'
+                          '**注意：这不是真实功能状态**，仅解锁被门禁的功能验证（hn-android FS-41 先例），'
+                          '需在用例/代码注释标明，且登录链路本身仍属未覆盖。')
+            reminders.append('登录域用例 BLOCKED 待解除：手动登录设备 / 提供测试账号 / mock 登录态（三选一，见 preconditions.md）')
+    else:
+        report.append('- 未检测到登录页，无需账号')
+    report.append('')
+
+    # ── 3. 首启弹窗预处置 ──
+    report.append('## 首启弹窗预处置（自动 dismiss 片段，注入 _common.launch）')
+    report.append('```python')
+    report.append('# 常见首启弹窗一键处理（在 launch 后 sleep 1 时执行）')
+    report.append('for txt in ["同意并继续", "允许", "我知道了", "暂不", "以后再说"]:')
+    report.append('    try:')
+    report.append('        c = d.find_component(BY.text(txt))')
+    report.append('        if c: c.click(); time.sleep(0.8)')
+    report.append('    except Exception: pass')
+    report.append('```')
+    report.append('')
+
+    if reminders:
+        report += ['## ⚠️ 用户提醒清单', *[f'- {r}' for r in reminders], '']
+    else:
+        report.append('## 用户提醒清单: 无（全部前置已自动完成）')
+
+    out_md = os.path.join(os.path.dirname(os.path.abspath(args.features)),
+                          'preconditions.md')
+    open(out_md, 'w', encoding='utf-8').write('\n'.join(report))
+    print('\n'.join(report))
+    print(f'\n报告: {out_md}')
+
+
+if __name__ == '__main__':
+    main()