iOS Issues

This page covers iOS-specific issues you may encounter when integrating ZETIC Melange.

Swift Package Manager Issues

Package Resolution Failure

Symptom: Xcode fails to resolve the Melange package with errors like "Failed to resolve dependencies" or "Unable to fetch repository."

Solutions:

• Verify the package URL is correct: https://github.com/zetic-ai/ZeticMLangeiOS
• Check your internet connection and try again.
• In Xcode, go to File then Packages then Reset Package Caches, then resolve again.
• If using a VPN or corporate proxy, ensure GitHub is accessible.

Version Conflicts

Symptom: Package version conflicts with other dependencies.

Solution: Try specifying a specific version or branch when adding the package dependency instead of using "Up to Next Major Version."

---

Code Signing Issues

Symptom: Build fails with signing errors related to the Melange framework.

Solutions:

• Ensure you have a valid development certificate and provisioning profile.
• In your target's Signing & Capabilities, verify the team and bundle identifier are correct.
• If using automatic signing, try toggling it off and on again.

---

Simulator Limitations

Symptom: Model runs on simulator but performance is unexpectedly slow, or you see degraded results.

Cause: iOS Simulators do not have Neural Engine hardware.

Solution: Always test on a physical device for accurate performance and results. The simulator will use CPU fallback.

---

Model Initialization Errors

Symptom: ZeticMLangeModel initializer throws an error.

Solutions:

• Verify your Personal Key is correct. Copy it from the Melange Dashboard.
• Verify your Model Key matches a compiled model that has reached "Ready" status.
• Ensure the device has network connectivity for the initial model download.
• Check that you are using a physical device, not a simulator (for NPU-dependent functionality).

---

App Transport Security

Symptom: Network requests fail with ATS-related errors.

Solution: The Melange SDK communicates over HTTPS, which should work with default ATS settings. If you have customized ATS settings in your Info.plist, ensure HTTPS connections are allowed.

---

Memory Warnings

Symptom: App receives memory warnings or crashes when loading large models.

Solutions:

• Ensure you are not holding references to multiple large model instances simultaneously.
• Release model instances when they are no longer needed.
• For LLM models, call cleanUp() to release the KV cache when done.

---

Still Having Issues?

• Check Common Errors for cross-platform issues
• Visit the FAQ
• Join the Discord community
• Email contact@zetic.ai