{"_id":"5b8469e2146f290003ee2530","category":{"_id":"5b8469e2146f290003ee24fc","version":"5b8469e2146f290003ee2585","project":"578c4badbd223d2000cc1441","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-03-17T18:59:29.780Z","from_sync":false,"order":1,"slug":"getting-started-ios","title":"iOS - Platform Setup"},"project":"578c4badbd223d2000cc1441","user":"57bb7e47afc18c0e00529cf3","parentDoc":null,"version":{"_id":"5b8469e2146f290003ee2585","project":"578c4badbd223d2000cc1441","__v":0,"forked_from":"5b74987b8326970003cfc12d","createdAt":"2018-04-23T20:03:35.726Z","releaseDate":"2018-04-23T20:03:35.726Z","categories":["5b8469e2146f290003ee24fb","5b8469e2146f290003ee24fc","5b8469e2146f290003ee24fd","5b8469e2146f290003ee24fe","5b8469e2146f290003ee24ff","5b8469e2146f290003ee2500","5b8469e2146f290003ee2501","5b8469e2146f290003ee2502","5b8469e2146f290003ee2503"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.10.0","version":"2.10.0"},"githubsync":"","__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-02-27T00:14:20.161Z","link_external":false,"link_url":"","sync_unique":"","hidden":true,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":5,"body":"# Prerequisites\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"Xcode Beta and a Paid Apple Developer account is required to use ARKit 1.5 Features\",\n  \"body\": \"Due to App Store restrictions, we can not release a Testbed application with ARKit 1.5 Features, as a result, to use ARKit 1.5 Features, you'll need to follow the instructions below to setup your device and Xcode Beta to build your application.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Have you already set up Xcode?\",\n  \"body\": \"Run through all the steps in the [Set up Xcode with ViroReact](doc:starting-a-new-viro-project-1) guide before running through this one.\"\n}\n[/block]\n# 1. Install Xcode Beta\n\nGo to this link and install Xcode 9.3 Beta: https://developer.apple.com/xcode/downloads/\n\n# 2. Install iOS 11.3 Beta on your Device\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"If you do this, you can no longer install to the device using previous versions of Xcode (non-Beta).\"\n}\n[/block]\nOn your iOS device, navigate to this page: https://developer.apple.com/download/ and install the Configuration Profile for iOS 11.3 Beta\n\n# 3. Update the `Podfile`\n\nOpen `<your_project>/ios/Podfile` and change the following line:\n\n```  pod 'ViroKit', :path => '../node_modules/react-viro/ios/dist/ViroRenderer/'```\n\nto:\n\n```  pod 'ViroKit', :path => '../node_modules/react-viro/ios/dist/beta/ViroRenderer/'```\n\nThen navigate to `<your_project>/ios/` in the Terminal and run:\n\n```pod install```\n\n# 4. Open the workspace in Xcode Beta\n\nOpen `<your_project>/ios/<your_project>.xcworkspace` in Xcode Beta and you should be set!\n\n# 5. Distribution\n\nARKit 1.5 is not publicly available so apps built using ARKit 1.5/Xcode Beta  can not be submitted to the App Store and released until Apple officially releases Xcode 9.3 and iOS 11.3 w/ ARKit 1.5.\n\nIf you need to release your application, simply undo step 3 above and open/rebuild your application using a non-beta version of Xcode. The Viro React components using ARKit 1.5 features will simply not appear, but no crashes should occur.","excerpt":"","slug":"enable-arkit-15-beta-features","type":"basic","title":"Enable ARKit 1.5 (Beta) Features"}

Enable ARKit 1.5 (Beta) Features


# Prerequisites [block:callout] { "type": "danger", "title": "Xcode Beta and a Paid Apple Developer account is required to use ARKit 1.5 Features", "body": "Due to App Store restrictions, we can not release a Testbed application with ARKit 1.5 Features, as a result, to use ARKit 1.5 Features, you'll need to follow the instructions below to setup your device and Xcode Beta to build your application." } [/block] [block:callout] { "type": "warning", "title": "Have you already set up Xcode?", "body": "Run through all the steps in the [Set up Xcode with ViroReact](doc:starting-a-new-viro-project-1) guide before running through this one." } [/block] # 1. Install Xcode Beta Go to this link and install Xcode 9.3 Beta: https://developer.apple.com/xcode/downloads/ # 2. Install iOS 11.3 Beta on your Device [block:callout] { "type": "danger", "title": "If you do this, you can no longer install to the device using previous versions of Xcode (non-Beta)." } [/block] On your iOS device, navigate to this page: https://developer.apple.com/download/ and install the Configuration Profile for iOS 11.3 Beta # 3. Update the `Podfile` Open `<your_project>/ios/Podfile` and change the following line: ``` pod 'ViroKit', :path => '../node_modules/react-viro/ios/dist/ViroRenderer/'``` to: ``` pod 'ViroKit', :path => '../node_modules/react-viro/ios/dist/beta/ViroRenderer/'``` Then navigate to `<your_project>/ios/` in the Terminal and run: ```pod install``` # 4. Open the workspace in Xcode Beta Open `<your_project>/ios/<your_project>.xcworkspace` in Xcode Beta and you should be set! # 5. Distribution ARKit 1.5 is not publicly available so apps built using ARKit 1.5/Xcode Beta can not be submitted to the App Store and released until Apple officially releases Xcode 9.3 and iOS 11.3 w/ ARKit 1.5. If you need to release your application, simply undo step 3 above and open/rebuild your application using a non-beta version of Xcode. The Viro React components using ARKit 1.5 features will simply not appear, but no crashes should occur.