{"_id":"590a04f8ed80861900cbc7b2","user":"55b2d5626862a10d00887af9","version":{"_id":"590a04f2ed80861900cbc737","project":"55b2d5baa74a380d00e290c4","__v":4,"createdAt":"2017-05-03T16:27:30.085Z","releaseDate":"2017-05-03T16:27:30.085Z","categories":["590a04f3ed80861900cbc738","590a04f3ed80861900cbc739","590a04f3ed80861900cbc73a","590a04f3ed80861900cbc73b","590a04f3ed80861900cbc73c","590a04f3ed80861900cbc73d","590a04f3ed80861900cbc73e","590a04f3ed80861900cbc73f","590a04f3ed80861900cbc740","590a04f3ed80861900cbc741","590a04f3ed80861900cbc742","590a04f3ed80861900cbc743","590a04f3ed80861900cbc744","590a04f3ed80861900cbc745","590a04f3ed80861900cbc746","590a04f3ed80861900cbc747","590a04f3ed80861900cbc748","590a04f3ed80861900cbc749","590a04f3ed80861900cbc74a","590a04f3ed80861900cbc74b","590a04f3ed80861900cbc74c","590a04f3ed80861900cbc74d","59124949de13f61900336a7a","5914b04e7c2c552d008b7104","5914b47242c6a22300b9dc20"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"7.0.0","version":"7"},"category":{"_id":"590a04f3ed80861900cbc74c","__v":0,"version":"590a04f2ed80861900cbc737","project":"55b2d5baa74a380d00e290c4","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-01-05T19:32:59.974Z","from_sync":false,"order":22,"slug":"troubleshooting","title":"Troubleshooting"},"project":"55b2d5baa74a380d00e290c4","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-02-01T07:29:44.206Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":9,"body":"### Build will not install on a device\n\nAlmost every case of an app not installing on a device is caused by an existing version of the app already installed conflicting with buddybuild's attempt to install it.\n\nIn particular, buddybuild cannot install on top of an App Store version. Please delete any App Store versions before attempting to install an app through buddybuild.\n\n### \"Unable to Download App\" message\n\nThis error is quite generic and could be caused by the following reasons, but not limited to:\n\n* UDID is not included in the provisioning profile\n* The build was incorrectly signed or has broken entitlements\n* Device or iOS version is incompatible with the build\n* Device storage is full\n* You've reached your device provisioning limit in your Apple Developer Account (See your  \"Remaining devices\" in your **App Settings > Integrations > Apple Developer Portal**)\n\nSometimes a \"Rebuild without cache\" might get you going, but if you are still experiencing this, we recommend you [get the device logs](http://docs.buddybuild.com/docs/getting-device-logs-from-xcode) and reach out to us on Intercom.\n\n### Private Browsing\n\nThis issue is caused when opening the link in **Private** mode in Safari. Here's how to turn off Private browsing:\n\n1. Tap the tabs button (the right most button in the toolbar below)\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/496d39b-IMG_3643.png\",\n        \"IMG_3643.png\",\n        1242,\n        2151,\n        \"#f2fafb\"\n      ],\n      \"sizing\": \"80\"\n    }\n  ]\n}\n[/block]\n2. Tap on \"Private\" to deselect it.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/760522c-IMG_3644.png\",\n        \"IMG_3644.png\",\n        1242,\n        2208,\n        \"#32363c\"\n      ],\n      \"sizing\": \"80\"\n    }\n  ]\n}\n[/block]\n3. Quit Safari, then click on the install link again.\n\nIf you still see this error message, make sure cookies are not disabled on your device.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/e861b18-Allow_Cookies.png\",\n        \"Allow Cookies.png\",\n        1032,\n        903,\n        \"#ebecf2\"\n      ]\n    }\n  ]\n}\n[/block]\n### Nothing happens when trying to register the device or to install the app\n\nThis issue is caused when opening the link in a **SFSafariViewController** (a stripped down version of Safari in third party apps) and not **Safari**, the main app itself.\n\nThe issue can be fixed by forcing the link to open in Safari. Then to install from Safari\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7157206-SFSafariViewController.png\",\n        \"SFSafariViewController.png\",\n        1242,\n        2144,\n        \"#e9eff2\"\n      ],\n      \"sizing\": \"80\"\n    }\n  ]\n}\n[/block]\n### Profile installation Failed: Couldn't communicate with a helper application\n\nWhen you get this error while trying to install the buddybuild profile, try the following:\n\n* Open the Settings app\n* Go to General > Profiles on the device\n* Remove the buddybuild config profile\n* Visit https://dashboard.buddybuild.com/reset\n* Try to reinstall the build, buddybuild should ask to install the profile again.","excerpt":"","slug":"trouble-installing-builds","type":"basic","title":"Trouble installing builds on iOS"}

Trouble installing builds on iOS


### Build will not install on a device Almost every case of an app not installing on a device is caused by an existing version of the app already installed conflicting with buddybuild's attempt to install it. In particular, buddybuild cannot install on top of an App Store version. Please delete any App Store versions before attempting to install an app through buddybuild. ### "Unable to Download App" message This error is quite generic and could be caused by the following reasons, but not limited to: * UDID is not included in the provisioning profile * The build was incorrectly signed or has broken entitlements * Device or iOS version is incompatible with the build * Device storage is full * You've reached your device provisioning limit in your Apple Developer Account (See your "Remaining devices" in your **App Settings > Integrations > Apple Developer Portal**) Sometimes a "Rebuild without cache" might get you going, but if you are still experiencing this, we recommend you [get the device logs](http://docs.buddybuild.com/docs/getting-device-logs-from-xcode) and reach out to us on Intercom. ### Private Browsing This issue is caused when opening the link in **Private** mode in Safari. Here's how to turn off Private browsing: 1. Tap the tabs button (the right most button in the toolbar below) [block:image] { "images": [ { "image": [ "https://files.readme.io/496d39b-IMG_3643.png", "IMG_3643.png", 1242, 2151, "#f2fafb" ], "sizing": "80" } ] } [/block] 2. Tap on "Private" to deselect it. [block:image] { "images": [ { "image": [ "https://files.readme.io/760522c-IMG_3644.png", "IMG_3644.png", 1242, 2208, "#32363c" ], "sizing": "80" } ] } [/block] 3. Quit Safari, then click on the install link again. If you still see this error message, make sure cookies are not disabled on your device. [block:image] { "images": [ { "image": [ "https://files.readme.io/e861b18-Allow_Cookies.png", "Allow Cookies.png", 1032, 903, "#ebecf2" ] } ] } [/block] ### Nothing happens when trying to register the device or to install the app This issue is caused when opening the link in a **SFSafariViewController** (a stripped down version of Safari in third party apps) and not **Safari**, the main app itself. The issue can be fixed by forcing the link to open in Safari. Then to install from Safari [block:image] { "images": [ { "image": [ "https://files.readme.io/7157206-SFSafariViewController.png", "SFSafariViewController.png", 1242, 2144, "#e9eff2" ], "sizing": "80" } ] } [/block] ### Profile installation Failed: Couldn't communicate with a helper application When you get this error while trying to install the buddybuild profile, try the following: * Open the Settings app * Go to General > Profiles on the device * Remove the buddybuild config profile * Visit https://dashboard.buddybuild.com/reset * Try to reinstall the build, buddybuild should ask to install the profile again.