> For the complete documentation index, see [llms.txt](https://docs.emobiq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.emobiq.com/emobiq-ai/readme/plugins/testing-on-debug-agent.md).

# Testing On Debug Agent

#### Verify Your Plugin Works: Even on Mobile Features Like Camera or GPS

Plugins unlock powerful native device capabilities like camera, GPS, file system, and more. But here's the catch: **you're building in a browser on your laptop.** How do you test a camera feature when your computer can't access your phone's camera?

**The answer: The Debug Agent and Real Device Testing**

💡 **Why This Matters**:\
You can't open your iPhone camera from your web browser on your laptop, but you *can* simulate how the plugin behaves. The Debug Agent gives you instant feedback without waiting for a full app build.

***

#### Trigger the Plugin in Debug Mode

Use the app as you would and test the functions that require the plugin.

Example: Testing the Camera Plugin

<figure><img src="/files/CWKUn3F0rdSPcKAKurYc" alt="" width="563"><figcaption></figcaption></figure>

* Click the "Take Photo" button in your app preview
* The Debug Agent simulates the plugin call
* You'll see a **web mockup** instead of the real camera opening
* Check the **eMOBIQ Terminal** for plugin logs and any error messages

**What You're Testing:** ✅ Does the button trigger the plugin correctly?\
✅ Does the app handle the returned image properly?\
✅ Are there any errors in the integration?

**What You're NOT Testing:** ❌ The actual camera hardware\
❌ Real-world performance on iOS/Android\
❌ Device-specific permissions or quirks

***

### Test on a Real Device (Full Validation)

For full native functionality (or plugins that don't support web):

1. **Click "Release"** in eMOBIQ
2. **Select Your Platform:**
   * **iOS:** Generates an `.ipa` file (requires Apple Developer account)
   * **Android:** Generates an `.apk` file (install directly or upload to Play Store)
3. **Install on Your Device:**
   * **Android:** Download the `.apk` and install (enable "Install from Unknown Sources")
   * **iOS:** Use TestFlight or Xcode to install the `.ipa`
4. **Test Every Plugin Feature:**
   * Tap "Take Photo" → Does the camera open?
   * Tap "Get Location" → Does GPS activate?
   * Save a file → Does it appear in device storage?

**Why This Step Is Critical:**

* Real device permissions (Camera, Location, Microphone)
* True performance metrics
* OS-specific behaviors (iOS vs Android differences)
* Full offline functionality
