/mobile-app-debugging

name: mobile-app-debugging
description: >
  Debug issues specific to mobile applications including platform-specific
  problems, device constraints, and connectivity issues.

Mobile App Debugging

Table of Contents

• [Overview](#overview)
• [When to Use](#when-to-use)
• [Quick Start](#quick-start)
• [Reference Guides](#reference-guides)
• [Best Practices](#best-practices)

Overview

Mobile app debugging addresses platform-specific issues, device hardware limitations, and mobile-specific network conditions.

When to Use

• App crashes on mobile
• Performance issues on device
• Platform-specific bugs
• Network connectivity issues
• Device-specific problems

Quick Start

Minimal working example:

Xcode Debugging:

Attach Debugger:
  - Xcode → Run on device
  - Set breakpoints in code
  - Step through execution
  - View variables
  - Console logs

View Logs:
  - Xcode → Window → Devices & Simulators
  - Select device → View Device Logs
  - Filter by app name
  - Check system logs for crashes

Inspect Memory:
  - Xcode → Debug → View Memory Graph
  - Identify retain cycles
  - Check object count
  - Monitor allocation growth

---
Common iOS Issues:

App Crash (SIGABRT):
// ... (see reference guides for full implementation)

Reference Guides

Detailed implementations in the `references/` directory:

| Guide | Contents | |---|---| | [iOS Debugging](references/ios-debugging.md) | iOS Debugging | | [Android Debugging](references/android-debugging.md) | Android Debugging | | [Cross-Platform Issues](references/cross-platform-issues.md) | Cross-Platform Issues | | [Mobile Testing & Debugging Checklist](references/mobile-testing-debugging-checklist.md) | Mobile Testing & Debugging Checklist |

Best Practices

✅ DO

• Follow established patterns and conventions
• Write clean, maintainable code
• Add appropriate documentation
• Test thoroughly before deploying

❌ DON'T

• Skip testing or validation
• Ignore error handling
• Hard-code configuration values