xc-mcp/dist/tools/simctl/uninstall.d.ts

MCP server that wraps Xcode command-line tools for iOS/macOS development workflows

/**
 * Uninstall iOS apps from simulators
 *
 * **What it does:**
 * Removes an installed app from a simulator by its bundle ID. This cleans up all app
 * data, preferences, and the app bundle itself from the simulator.
 *
 * **Why you'd use it:**
 * - Clean testing enables fresh installation testing after uninstall
 * - Data removal clears all app data and preferences completely
 * - Space management frees simulator disk space by removing unused apps
 * - Workflow automation supports test cycles requiring clean app installs
 *
 * **Parameters:**
 * - `udid` (string): Simulator UDID (from simctl-list)
 * - `bundleId` (string): App bundle ID (e.g., com.example.MyApp)
 *
 * **Returns:**
 * Uninstall status with bundle ID, simulator info, and guidance for reinstallation
 *
 * **Example:**
 * ```typescript
 * // Uninstall app from simulator
 * await simctlUninstallTool({
 *   udid: 'ABC-123-DEF',
 *   bundleId: 'com.example.MyApp'
 * })
 * ```
 *
 * **Full documentation:** See simctl/uninstall.md for app management patterns
 *
 * @param args Uninstall configuration (requires udid and bundleId)
 * @returns Tool result with uninstall status and guidance
 * @throws McpError for invalid bundle ID or uninstall failure
 */
export declare function simctlUninstallTool(args: any): Promise<{
    content: {
        type: "text";
        text: string;
    }[];
    isError: boolean;
}>;
export declare const SIMCTL_UNINSTALL_DOCS = "\n# simctl-uninstall\n\nUninstall iOS apps from simulators.\n\n## Overview\n\nRemoves an installed app from a simulator by its bundle ID. This cleans up all app data, preferences, and the app bundle itself from the simulator. Useful for clean testing, data removal, space management, and workflow automation.\n\n## Parameters\n\n### Required\n- **udid** (string): Simulator UDID (from simctl-list)\n- **bundleId** (string): App bundle ID (e.g., com.example.MyApp)\n\n## Returns\n\nUninstall status with bundle ID, simulator info (name, state, availability), success indicator, command output, and guidance for reinstallation or app management.\n\n## Examples\n\n### Uninstall app from simulator\n```typescript\nawait simctlUninstallTool({\n  udid: 'ABC-123-DEF',\n  bundleId: 'com.example.MyApp'\n});\n```\n\n### Clean install workflow\n```typescript\n// Uninstall old version\nawait simctlUninstallTool({\n  udid: 'TEST-DEVICE',\n  bundleId: 'com.example.MyApp'\n});\n// Then reinstall\nawait simctlInstallTool({\n  udid: 'TEST-DEVICE',\n  appPath: '/path/to/MyApp.app'\n});\n```\n\n## Related Tools\n\n- simctl-install: Reinstall app after uninstall\n- simctl-list: Find simulator UDID\n- simctl-get-app-container: Check app container before uninstall\n\n## Notes\n\n- Bundle ID must follow format: com.company.appname\n- Removes app and all associated data/preferences\n- Validates simulator exists before attempting uninstall\n- Useful for clean testing workflows\n- Frees simulator disk space by removing unused apps\n- Test cycles requiring clean app installs benefit from uninstall automation\n";
//# sourceMappingURL=uninstall.d.ts.map