xc-mcp
Version:
MCP server that wraps Xcode command-line tools for iOS/macOS development workflows
56 lines • 3.69 kB
TypeScript
interface IdbUninstallArgs {
udid?: string;
bundleId: string;
}
/**
* Uninstall application from iOS target - remove apps with complete data deletion for clean installs
*
* **What it does:**
* Removes installed applications by bundle ID with complete data and preferences deletion. Automatically
* terminates running apps before uninstall. Cannot remove system apps (user-installed only). Provides
* detailed error guidance for common failures (app not found, system app protection, uninstall errors).
*
* **Why you'd use it:**
* - Clean install testing workflows - remove old version completely before installing new build
* - Reset app state by deleting all data and preferences (more thorough than terminate alone)
* - Free device storage by removing unused test apps from device farms
* - Automate uninstall/reinstall cycles for testing fresh installs and onboarding flows
*
* **Parameters:**
* - bundleId (required): App bundle identifier to uninstall
* - udid (optional): Target identifier - auto-detects if omitted
*
* **Returns:**
* Uninstallation status with success indicator, bundle ID, command output, error details
* if failed, and troubleshooting guidance (app not found, system app protection, termination
* advice, alternative tools).
*
* **Example:**
* ```typescript
* // Uninstall app for clean reinstall
* const result = await idbUninstallTool({
* bundleId: 'com.example.MyApp'
* });
*
* // Uninstall from specific device
* await idbUninstallTool({
* bundleId: 'com.example.MyApp',
* udid: 'DEVICE-UDID-123'
* });
* ```
*
* **Full documentation:** See idb/uninstall.md for detailed parameters and behavior
*
* @param args Tool arguments with bundle ID and optional target UDID
* @returns Tool result with uninstallation status and guidance
*/
export declare function idbUninstallTool(args: IdbUninstallArgs): Promise<{
content: {
type: "text";
text: string;
}[];
isError: boolean;
}>;
export declare const IDB_UNINSTALL_DOCS = "\n# idb-uninstall\n\nUninstall application from iOS target - remove apps with complete data deletion for clean installs.\n\n## Overview\n\nRemoves installed applications by bundle ID with complete data and preferences deletion. Automatically terminates running apps before uninstall. Cannot remove system apps (user-installed only). Provides detailed error guidance for common failures (app not found, system app protection, uninstall errors).\n\n## Parameters\n\n### Required\n- **bundleId** (string): App bundle identifier to uninstall\n\n### Optional\n- **udid** (string): Target identifier - auto-detects if omitted\n\n## Returns\n\nUninstallation status with success indicator, bundle ID, command output, error details if failed, and troubleshooting guidance (app not found, system app protection, termination advice, alternative tools).\n\n## Examples\n\n### Uninstall app for clean reinstall\n```typescript\nconst result = await idbUninstallTool({\n bundleId: 'com.example.MyApp'\n});\n```\n\n### Uninstall from specific device\n```typescript\nawait idbUninstallTool({\n bundleId: 'com.example.MyApp',\n udid: 'DEVICE-UDID-123'\n});\n```\n\n## Related Tools\n\n- idb-install: Reinstall app after uninstall\n- idb-terminate: Stop app before uninstall (auto-handled)\n- idb-list-apps: Verify app is removed after uninstall\n\n## Notes\n\n- Removes app from target system completely\n- Deletes all app data and preferences\n- Automatically terminates app if running\n- Only user-installed apps can be uninstalled (system apps protected)\n- Clean install testing workflow: uninstall -> install -> test\n";
export {};
//# sourceMappingURL=uninstall.d.ts.map