Troubleshooting
Common errors and their solutions for iOS and Android publishing.
If your app shows "Failed" in AppMyWeb, it's usually due to a configuration issue. The system doesn't show detailed error messages, so you'll need to check common causes. Below are the most frequent problems and how to fix them.
iOS Publishing Failed
If your iOS publish shows "Failed", check these common causes. iOS builds are more likely to fail than Android because Apple requires exact matching of identifiers.
â Publishing Failed â Check These Issues
Most common causes:
đ Invalid or Missing API Key
Check: Go to Services â Key Manager. Verify your iOS API Key exists and has correct Issuer ID, Key ID, and .p8 file.
Fix: Re-create API Key in App Store Connect with Admin access.
đ Bundle ID Mismatch
Check: Your App ID in AppMyWeb (Main Info) must match Bundle ID in App Store Connect exactly.
Fix: Create app in App Store Connect first, or update one to match the other.
đą App Name Mismatch
Check: App Name in AppMyWeb must match App Name in App Store Connect exactly (including spaces and capitalization).
Fix: Update one to match the other exactly.
đ API Key Without Admin Permissions
Check: Your API Key must have Admin access, not just App Manager or Developer.
Fix: Create new API Key with Admin access in App Store Connect.
đ Invalid Version Number
Check: Version must be in format 1.0.0 (three numbers separated by dots).
Fix: Update version in App Settings â Main Info to correct format.
đŧī¸ Missing or Invalid Launch Icon
Check: Launch icon must be 1024Ã1024 PNG with solid background (no transparency).
Fix: Upload new icon in App Settings â Launch Icon. If your icon has a transparent background, Apple will reject it. Use an image editor to add a solid background color.
đŧī¸ Transparent Launch Icon Background
Check: Your launch icon has a transparent background (alpha channel). Apple rejects icons with transparency.
Fix: Open your icon in an image editor (Photoshop, GIMP, or online tools) and add a solid background color. Save as PNG without transparency. Then upload the new icon.
Before publishing iOS: â App created in App Store Connect â Bundle ID matches exactly â App Name matches exactly â API Key has Admin access â Valid version number (1.0.0) â Launch icon uploaded (1024Ã1024 PNG)
Android Publishing Failed
If your Android publish shows "Failed", check these common causes. Android builds are generally more reliable than iOS.
â Publishing Failed â Check These Issues
Most common causes:
đ Missing Signing Key
Check: Go to Services â Key Manager. Verify you have an Android keystore created.
Fix: Create new Android key in Key Manager.
đ Invalid Keystore
Check: If you uploaded a keystore, verify the file isn't corrupted and passwords are correct.
Fix: Delete and create new key, or let AppMyWeb generate one automatically.
đ Invalid Version Number
Check: Version must be in format 1.0.0 (three numbers separated by dots).
Fix: Update version in App Settings â Main Info to correct format.
đ Version Already Used
Check: If updating an existing app, version must be higher than the previous version.
Fix: Increase version number (e.g., 1.0.0 â 1.0.1) before building.
đŧī¸ Missing Launch Icon
Check: Launch icon must be uploaded (1024Ã1024 PNG).
Fix: Upload icon in App Settings â Launch Icon.
Go to App Settings â Main Info â Version. Use format like 1.0.0, 1.0.1, 2.0.0. Each new publish must have a higher version.
General Issues
These are common issues that can affect any platform or general app functionality. If your problem isn't listed in the iOS or Android sections, check here.
â Publishing Stuck or Taking Too Long
âąī¸ Normal Wait
Publishing typically takes 5â15 minutes. iOS may take longer.
đ If Stuck
Refresh the page. If still stuck after 30 mins, contact support.
â App Not Showing Updated Content
â Solution
Click "SAVE CHANGES" after every modification. Then re-publish your app. Changes require a new publish to take effect.
â Website Not Loading in App
đ HTTPS Required
Your website must use HTTPS, not HTTP.
đą Mobile Responsive
Ensure your website is mobile-friendly.
â Store Rejection: Minimal Functionality
đ Add Features
Enable push notifications. Add navigation buttons.
đ Better Description
Explain your app's unique value in the store listing.