鱼皮AI导航
鱼皮AI导航
  • 主页
  • 社区
  • AI工具
  • AI知识库
  • AI提示词
  • MCP
  • Skills
  • AI学习资源
  • AI资讯
  • GitHub开源
登录/注册

mobile-use-setup

提供面向 iOS 和 Android 的移动自动化开发环境初始化服务,涵盖设备连接配置、SDK 项目创建、AI 模型接入方式选择及本地或云端测试环境搭建,支持物理设备与模拟器的全流程引导。

效率工具商业与营销软件开发
访问 GitHub
文档Skills.MD
name
mobile-use-setup
description
Interactive setup wizard for Minitap mobile-use SDK. USE WHEN user wants to set up mobile automation, configure mobile-use SDK, connect iOS or Android devices, or create a new mobile testing project.

Mobile-Use SDK Setup Wizard

Interactive guide for setting up the Minitap mobile-use SDK with support for iOS and Android devices, Platform and Local modes.

When to Apply

This skill activates when users want to:

  • Set up mobile automation for an app
  • Configure the Minitap mobile-use SDK
  • Connect physical iOS or Android devices
  • Set up cloud virtual devices
  • Create a new mobile testing project

Setup Flow

Phase 1: Gather Requirements

Ask the user these questions using the AskUserQuestion tool:

  1. Target Platform

    • Question: "Which platform(s) do you want to automate?"
    • Options: iOS only, Android only, Both iOS and Android
  2. LLM Configuration Mode

    • Question: "How do you want to configure AI/LLM?"
    • Options:
      • Platform (Recommended) - Minitap handles LLM config, just need API key
      • Local - Full control with local config files and your own API keys
  3. Device Type (if iOS selected)

    • Question: "What iOS device setup do you need?"
    • Options:
      • Physical device (iPhone/iPad via USB)
      • Simulator (Xcode iOS Simulator)
  4. Device Type (if Android selected)

    • Question: "What Android device setup do you need?"
    • Options:
      • Physical device (via USB/WiFi ADB)
      • Cloud device (Minitap virtual Android)

Phase 2: Check Prerequisites

Run these checks based on user selections:

▼
bash
复制代码
# Always check python3 --version # Requires 3.12+ which uv # Package manager # For iOS physical device which idevice_id # libimobiledevice which appium # Appium appium driver list # XCUITest driver # For iOS simulator which idb_companion # Facebook idb # For Android which adb # Android platform tools adb devices # Device connection

Phase 3: Install Missing Dependencies

iOS Physical Device Setup:

▼
bash
复制代码
# Install libimobiledevice brew install libimobiledevice # Install Appium + XCUITest npm install -g appium appium driver install xcuitest

iOS Simulator Setup:

▼
bash
复制代码
brew tap facebook/fb brew install idb-companion

Android Setup:

▼
bash
复制代码
# macOS brew install --cask android-platform-tools # Linux sudo apt install android-tools-adb

UV Package Manager:

▼
bash
复制代码
curl -LsSf https://astral.sh/uv/install.sh | sh

Phase 4: Create Project

▼
bash
复制代码
# Create new project uv init <project-name> cd <project-name> # Add SDK uv add minitap-mobile-use python-dotenv

Phase 5: Configure Credentials

For Platform Mode:

  1. Direct user to https://platform.minitap.ai to create account
  2. Navigate to API Keys → Create API Key
  3. Create .env file:
▼
text
复制代码
MINITAP_API_KEY=<their-key>
  1. Add .env to .gitignore

For Local Mode:

  1. Copy the config template:
    ▼
    bash
    复制代码
    cp llm-config.override.template.jsonc llm-config.override.jsonc
  2. Edit llm-config.override.jsonc with preferred models (refer to llm-config.defaults.jsonc for recommended settings)
  3. Add provider API keys to .env (OPENAI_API_KEY, etc.) or set MINITAP_API_KEY for optimized config

Phase 6: Device-Specific Setup

iOS Physical Device (requires manual Xcode steps):

Inform user they need to:

  1. Open WebDriverAgent in Xcode:
    ▼
    bash
    复制代码
    open ~/.appium/node_modules/appium-xcuitest-driver/node_modules/appium-webdriveragent/WebDriverAgent.xcodeproj
  2. Sign these targets with their Apple ID:
    • WebDriverAgentRunner
    • WebDriverAgentLib
    • IntegrationApp
  3. Change Bundle IDs to unique values
  4. Build IntegrationApp once with device connected
  5. Trust developer certificate on device: Settings → General → VPN & Device Management

Android Physical Device:

Inform user they need to:

  1. Enable Developer Options (tap Build Number 7 times)
  2. Enable USB Debugging
  3. Connect device and tap "Allow" on USB debugging prompt

Phase 7: Create Starter Script

Generate main.py based on configuration:

Platform Mode:

▼
python
复制代码
import asyncio from dotenv import load_dotenv from minitap.mobile_use.sdk import Agent from minitap.mobile_use.sdk.types import PlatformTaskRequest load_dotenv() async def main() -> None: agent = Agent() await agent.init() result = await agent.run_task( request=PlatformTaskRequest(task="your-task-name") ) print(result) await agent.clean() if __name__ == "__main__": asyncio.run(main())

Local Mode:

▼
python
复制代码
import asyncio from dotenv import load_dotenv from minitap.mobile_use.sdk import Agent from minitap.mobile_use.sdk.types import AgentProfile from minitap.mobile_use.sdk.builders import Builders load_dotenv() async def main() -> None: profile = AgentProfile(name="default", from_file="llm-config.override.jsonc") config = Builders.AgentConfig.with_default_profile(profile).build() agent = Agent(config=config) await agent.init() result = await agent.run_task( goal="Your automation goal here", name="task-name" ) print(result) await agent.clean() if __name__ == "__main__": asyncio.run(main())

Phase 8: Verify Setup

Run verification based on device type:

▼
bash
复制代码
# iOS physical idevice_id -l # iOS simulator xcrun simctl list devices # Android adb devices # Test SDK import uv run python -c "from minitap.mobile_use.sdk import Agent; print('SDK OK')"

Quick Reference

Setup TypeKey DependenciesVerification
iOS PhysicalAppium, XCUITest, libimobiledeviceidevice_id -l
iOS Simulatoridb-companionxcrun simctl list
Android PhysicalADBadb devices
Android CloudNone (Platform only)N/A

Troubleshooting

IssueSolution
Python < 3.12Install Python 3.12+ via pyenv or homebrew
UV not foundcurl -LsSf https://astral.sh/uv/install.sh | sh
idevice_id not foundbrew install libimobiledevice
ADB not foundbrew install --cask android-platform-tools
WDA build failsCheck Xcode signing for all 3 targets
Device unauthorizedEnable USB debugging, tap Allow on device
CLT version errorsudo xcode-select --install

Examples

Example 1: New iOS automation project

▼
text
复制代码
User: "Help me set up mobile automation for my iOS app" → Ask: Platform preference (iOS), Mode (Platform), Device (Physical) → Check: python3, uv, libimobiledevice, appium → Install: Missing dependencies → Create: Project with uv init → Configure: .env with MINITAP_API_KEY → Guide: Xcode WebDriverAgent signing → Verify: idevice_id -l shows device

Example 2: Android cloud setup

▼
text
复制代码
User: "Set up mobile testing with cloud devices" → Ask: Platform (Android), Mode (Platform), Device (Cloud) → Check: python3, uv → Create: Project with uv init → Configure: .env with MINITAP_API_KEY → Guide: Create Virtual Mobile on platform.minitap.ai → Generate: main.py with for_cloud_mobile config

Example 3: Full local development setup

▼
text
复制代码
User: "I want full control over LLM config for mobile automation" → Ask: Platform (Both), Mode (Local), Devices (Physical) → Check: All dependencies → Create: Project, llm-config.override.jsonc → Configure: Provider API keys in .env → Guide: Device-specific setup for iOS and Android → Generate: main.py with local profile config
效率工具
商业与营销
软件开发

快捷安装

复制到终端去安装 Skill

npxskillsaddminitap-ai/mobile-use--skill"mobile-use-setup"
站长:程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
站长:程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
🔥热门工具
朱雀AI检测朱雀AI检测
朱雀AI检测助手朱雀AI检测助手
LovartLovart
老鱼简历老鱼简历
WritePass官网WritePass官网
面多多面多多
CursorCursor
星月写作星月写作
朱雀AI检测助手朱雀AI检测助手
零感AI零感AI
Skills 推荐
debug
debug 是一个系统化定位软件缺陷根因的技能,适用于用户报告 'fix'、'broken'、'error' 等问题或测试意外失败时。它通过可验证的假设、最小复现、因果链分析和回归测试,确保在修复前准确定位根本原因。
retrieving-developer-knowledge
retrieving-developer-knowledge 用于搜索、获取和整合 Google 官方开发者文档,覆盖 Google Cloud、AI/Gemini、Android、Chrome、Web、Flutter、Go、Firebase 等平台,适用于查询 gcloud CLI 命令、API 语法、IAM 权限或架构对比等场景。
diff-intake
diff-intake 读取 PR 或分支差异,生成结构化 YAML 变更摘要,用于下游 analytics instrumentation 技能。适用于用户提交 PR 链接、分支对比或原始 diff 后需理解变更内容、评估分析覆盖或启动埋点流程的场景。
webapp-testing
提供本地 Web 应用的端到端测试能力,支持页面导航、元素交互、表单填写、动态等待、断言验证、截图捕获、浏览器日志收集及网络请求拦截,适用于前端功能验证与 UI 行为调试。
definition-of-done-generator
自动生成项目完成标准的规范定义与配置文件,提供符合企业级工作流要求的最佳实践指导,输出可直接投入生产环境的代码和验证结果,适用于需要标准化流程审批、合规审查及跨系统集成的复杂项目管理场景。