android-midscene-automation 0.1.14 → 0.1.16

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # 更新记录
 
+## v0.1.16
+
+- 参数配置页调整卡片顺序，将“预设 App 参数”移动到“运行配置”下方。
+
+## v0.1.15
+
+- README 新增 Midscene 与 Appium 两种测试方式对比，明确 Midscene 必须配置模型，Appium 不依赖模型。
+- README 环境要求补充 Appium 3.x、UiAutomator2 Driver 的安装与启动说明。
+- README 明确 Android 测试不需要 Playwright Chromium，仅源码中的 Web E2E 示例需要单独安装。
+
 ## v0.1.14
 
 - 参数配置新增 Android SDK 路径和 Appium 回放报告目录；留空时分别读取系统默认 SDK 和启动目录下的 `output`。

package/README.md

@@ -18,7 +18,16 @@ Appium 方案完全不依赖大模型，不需要填写 Base URL、API Key、Mod
 - Node.js 18+
 - npm
 - Android SDK / ADB，移动端自动化测试需要
-- Playwright Chromium，Web 示例脚本需要
+- Appium 3.x 和 UiAutomator2 Driver，仅 Appium 录制回放方式需要
+
+安装 Appium 相关依赖：
+
+```sh
+npm install -g appium@3.5.0
+appium driver install uiautomator2
+```
+
+使用 Appium 方式前需要运行 `appium` 启动服务；只使用 Midscene 时不需要安装或启动 Appium。
 
 ## 启动
 
@@ -52,7 +61,13 @@ npm install
 npm run dev
 ```
 
-`Playwright` 浏览器下载不走 npm registry。单独安装浏览器时，可临时指定镜像：
+Midscene Android 测试和 Appium 测试都不需要 Playwright Chromium。只有运行源码中的 Web E2E 示例时才需要单独安装：
+
+```sh
+npx playwright install chromium
+```
+
+Playwright 浏览器下载不走 npm registry。下载较慢时，可临时指定镜像：
 
 ```sh
 PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright/ npx playwright install chromium

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "android-midscene-automation",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "type": "module",
   "bin": {
     "android-midscene-automation": "./bin/android-midscene-automation.js"

package/src/pages/ConfigPage.vue

@@ -112,6 +112,45 @@ const updateMidsceneProvider = (value: string) => {
         </el-form>
       </el-card>
 
+      <el-card shadow="never" class="config-module-card">
+        <template #header>
+          <div class="panel-header">
+            <div class="panel-header__title">
+              <span>预设 App 参数</span>
+              <el-tag v-if="appPresetForm.id" size="small" type="warning">编辑中</el-tag>
+            </div>
+            <div class="panel-header__actions">
+              <el-button type="primary" :loading="isSavingAppPreset" @click="$emit('saveAppPreset')">
+                {{ appPresetForm.id ? '保存修改' : '保存 App' }}
+              </el-button>
+            </div>
+          </div>
+        </template>
+
+        <el-form label-position="top">
+          <el-form-item label="App 名称">
+            <el-input v-model="appPresetForm.name" placeholder="例如：示例 App" />
+          </el-form-item>
+          <el-form-item label="App 包名">
+            <el-input v-model="appPresetForm.packageName" placeholder="例如：com.example.app" />
+          </el-form-item>
+        </el-form>
+
+        <div class="app-preset-list">
+          <div v-for="app in appPresets" :key="app.id" class="app-preset-row">
+            <div class="app-preset-row__main">
+              <strong>{{ app.name }}</strong>
+              <span>{{ app.packageName }}</span>
+            </div>
+            <div class="script-row__actions">
+              <el-button text size="small" :icon="Edit" @click="$emit('editAppPreset', app)" />
+              <el-button text size="small" :icon="Delete" @click="$emit('deleteAppPreset', app.id)" />
+            </div>
+          </div>
+          <el-empty v-if="!appPresets.length" description="暂无预设 App" />
+        </div>
+      </el-card>
+
       <el-card shadow="never" class="config-module-card">
         <template #header>
           <div class="panel-header">
@@ -258,44 +297,6 @@ const updateMidsceneProvider = (value: string) => {
         />
       </el-card>
 
-      <el-card shadow="never" class="config-module-card">
-        <template #header>
-          <div class="panel-header">
-            <div class="panel-header__title">
-              <span>预设 App 参数</span>
-              <el-tag v-if="appPresetForm.id" size="small" type="warning">编辑中</el-tag>
-            </div>
-            <div class="panel-header__actions">
-              <el-button type="primary" :loading="isSavingAppPreset" @click="$emit('saveAppPreset')">
-                {{ appPresetForm.id ? '保存修改' : '保存 App' }}
-              </el-button>
-            </div>
-          </div>
-        </template>
-
-        <el-form label-position="top">
-          <el-form-item label="App 名称">
-            <el-input v-model="appPresetForm.name" placeholder="例如：示例 App" />
-          </el-form-item>
-          <el-form-item label="App 包名">
-            <el-input v-model="appPresetForm.packageName" placeholder="例如：com.example.app" />
-          </el-form-item>
-        </el-form>
-
-        <div class="app-preset-list">
-          <div v-for="app in appPresets" :key="app.id" class="app-preset-row">
-            <div class="app-preset-row__main">
-              <strong>{{ app.name }}</strong>
-              <span>{{ app.packageName }}</span>
-            </div>
-            <div class="script-row__actions">
-              <el-button text size="small" :icon="Edit" @click="$emit('editAppPreset', app)" />
-              <el-button text size="small" :icon="Delete" @click="$emit('deleteAppPreset', app.id)" />
-            </div>
-          </div>
-          <el-empty v-if="!appPresets.length" description="暂无预设 App" />
-        </div>
-      </el-card>
     </section>
   </div>
 </template>