{"_id":"59bc03d41d2d8d001a3445af","category":{"_id":"59bc03d31d2d8d001a34457e","version":"59bc03d31d2d8d001a34457d","project":"578c4badbd223d2000cc1441","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-10-25T23:36:45.975Z","from_sync":false,"order":0,"slug":"basics","title":"Getting Started"},"user":"57bb7e47afc18c0e00529cf3","project":"578c4badbd223d2000cc1441","parentDoc":null,"version":{"_id":"59bc03d31d2d8d001a34457d","project":"578c4badbd223d2000cc1441","__v":2,"createdAt":"2017-09-15T16:46:11.721Z","releaseDate":"2017-09-15T16:46:11.721Z","categories":["59bc03d31d2d8d001a34457e","59bc03d31d2d8d001a34457f","59bc03d31d2d8d001a344580","59bc03d31d2d8d001a344581","59bc03d31d2d8d001a344582","59bc03d31d2d8d001a344583","59bc284b7c3f420010f965e6"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2.0.0"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-11-16T00:32:47.911Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Every react-viro release has a `Compatible with react-native` version\",\n  \"body\": \"This means that we have extensively tested the Viro platform to work with that version of react-native. While older or newer versions of react-native may work with Viro, there may be issues or differences that cause Viro to not work properly with older or newer versions of react-native.\"\n}\n[/block]\n#react-viro v2.0.0 | react-viro-cli v2.0.0 (Compatible with React Native v0.47.2)\n\nIt's here! We're happy to announce the release of Viro v2.0 with support for [Augmented Reality (AR)](doc:augmented-reality-ar) w/ Apple's ARKit! That means that you, everyone you know, and everyone you don't (because we're free to use) can use Viro to build the AR experiences you've been dreaming of building! Don't worry VR users, we didn't forget about you either! There are a lot of features that we've added to the core Viro platform like a full fledged *Physics* engine and *Particle* support (iOS only for now)! Read the notes below to see what other goodies we've packed into our v2.0 release!\n\n### Updates\n\n**AR Support** - With our new Augmented Reality (AR) support, we've Augmented your world with our platform so that you can build AR stuff too! (iOS 11+ support only)\n**Physics Support** - Ever feel like you just weren't connecting with your objects? Well, with our new physics engine support, now you can! (All platforms supported!)\n**FBX Object Support** - FBX is to OBJ as cars are to horse-led carriages, it's that much better! Check out the [3D Objects](doc:3d-objects) guide. (All platforms supported!)\n**Particles Support** - Having a bad day? How about adding some confetti? Or fireworks? Or maybe some snow because you just can't wait for ski season to start? It's now a possibility with our platform! (iOS support only)\n**Shadows Support** - With Viro 1.0, we had lights. We've worked really hard, but now we also have shadows (iOS support only)\n**Animation Changes** - With Viro 2.0, we've decided to retire [ViroAnimatedComponent](doc:viroanimatedcomponent), but never fear, we've just decided to go with an `animation` prop on our components! Check out our [Animation](doc:animation) guide for more details.\n**Many Other Changes** - We've changed a whole lot, added a lot more callbacks and methods on various components. It's too long to list here, but they've all been added below!\n\nWe're looking forward to the amazing things everyone will build on the platform!\n\n*2017.09.18*\n\n#react-viro v1.1.0 | react-viro-cli v1.1.0 (Compatible with React Native v0.43)\n\n### New Features\n\n**Stereoscopic Image/Video Support** - We added support for stereoscopic 3D assets! Check out the new `stereoMode` prop for image and video components in the API References.\n**onFuse Callbacks** - Another frequently requested feature, we added onFuse callbacks to all interactable components so you can now fuse to your heart's content.\n**Image Fill Types** - Allows developers to better control the display and size of their images. Refer to [ViroImage](doc:viroimage).\n**Normal Materials** - Support for normal materials will make scenes and objects look even more realistic. Best if use in conjunction with lights.\n**Buffering Start/End Notification** - Buffering notification support for videos. Now you can display an awesome [ViroSpinner](doc:virospinner) if your videos buffer!\n**Additional SceneNavigation Functionality** - Read more about it at [Scene Navigation](doc:scene-navigation).\n** New Code Samples ** - Product Showcase and VR Media Player - We just added two more new and awesome code samples with which to play and get started! Check them out here: [Code Samples](doc:code-samples).\n\n### Fixes\n- Too many to list here, but our platform is now more stable and performs better! If you see anything, feel free to contact us or file an issue at the link at the top of this page.\n\n### Upgrade Instructions\n\nFor those of you running `react-viro v1.0.0`, the following instructions will guide you through updating your Viro project.\n\n1. In your terminal, run the command `npm update -g react-viro-cli` - this will update your react-viro-cli to the latest and will ensure that you won't need to perform this step every time you do `react-viro init`\n2. Change these dependencies in your Viro project's `package.json` file:\n  - react 15.4.2 -> 16.0.0-alpha.6\n  - react-native 0.41.2 -> 0.43.3\n  - react-viro 1.0.0 -> 1.1.0\n  - react-test-renderer 15.4.2 -> 16.0.0-alpha.6\n\n  Your package.json dependencies should now look like the following:\n  ```\n  \"dependencies\": {\n    \"react\": \"16.0.0-alpha.6\",\n    \"react-native\": \"0.43.3\",\n    \"react-viro\": \"1.1.0\"\n  },\n  \"devDependencies\": {\n    \"babel-jest\": \"19.0.0\",\n    \"babel-preset-react-native\": \"1.9.1\",\n    \"jest\": \"19.0.2\",\n    \"react-test-renderer\": \"16.0.0-alpha.6\"\n  },\n```\n3. Also in your `package.json` add the following line to the `scripts` section: `    \"prestart\": \"./node_modules/react-viro/bin/run_ngrok.sh\",`\n4. Simply run `npm install`. Once that completes, you should now be able to use our v1.1.0 features!\n\n#react-viro v1.0.0 (Compatible with react-native v0.41.2)\n\nThis is it! We've launched our v1.0.0 and with it we have Cardboard for Android/iOS, GearVR and Daydream support! We're excited for you to get started developing, so head on over to our website and [sign up](http://www.viromedia.com/signup) for a key to access Viro!\n\np.s. As with all new releases (especially one as grand as this), there may be a few small issues so bear with us as we iron out the kinks. Check out the links at the top of this page if you need to contact us.","excerpt":"","slug":"releases","type":"basic","title":"Releases"}
[block:callout] { "type": "info", "title": "Every react-viro release has a `Compatible with react-native` version", "body": "This means that we have extensively tested the Viro platform to work with that version of react-native. While older or newer versions of react-native may work with Viro, there may be issues or differences that cause Viro to not work properly with older or newer versions of react-native." } [/block] #react-viro v2.0.0 | react-viro-cli v2.0.0 (Compatible with React Native v0.47.2) It's here! We're happy to announce the release of Viro v2.0 with support for [Augmented Reality (AR)](doc:augmented-reality-ar) w/ Apple's ARKit! That means that you, everyone you know, and everyone you don't (because we're free to use) can use Viro to build the AR experiences you've been dreaming of building! Don't worry VR users, we didn't forget about you either! There are a lot of features that we've added to the core Viro platform like a full fledged *Physics* engine and *Particle* support (iOS only for now)! Read the notes below to see what other goodies we've packed into our v2.0 release! ### Updates **AR Support** - With our new Augmented Reality (AR) support, we've Augmented your world with our platform so that you can build AR stuff too! (iOS 11+ support only) **Physics Support** - Ever feel like you just weren't connecting with your objects? Well, with our new physics engine support, now you can! (All platforms supported!) **FBX Object Support** - FBX is to OBJ as cars are to horse-led carriages, it's that much better! Check out the [3D Objects](doc:3d-objects) guide. (All platforms supported!) **Particles Support** - Having a bad day? How about adding some confetti? Or fireworks? Or maybe some snow because you just can't wait for ski season to start? It's now a possibility with our platform! (iOS support only) **Shadows Support** - With Viro 1.0, we had lights. We've worked really hard, but now we also have shadows (iOS support only) **Animation Changes** - With Viro 2.0, we've decided to retire [ViroAnimatedComponent](doc:viroanimatedcomponent), but never fear, we've just decided to go with an `animation` prop on our components! Check out our [Animation](doc:animation) guide for more details. **Many Other Changes** - We've changed a whole lot, added a lot more callbacks and methods on various components. It's too long to list here, but they've all been added below! We're looking forward to the amazing things everyone will build on the platform! *2017.09.18* #react-viro v1.1.0 | react-viro-cli v1.1.0 (Compatible with React Native v0.43) ### New Features **Stereoscopic Image/Video Support** - We added support for stereoscopic 3D assets! Check out the new `stereoMode` prop for image and video components in the API References. **onFuse Callbacks** - Another frequently requested feature, we added onFuse callbacks to all interactable components so you can now fuse to your heart's content. **Image Fill Types** - Allows developers to better control the display and size of their images. Refer to [ViroImage](doc:viroimage). **Normal Materials** - Support for normal materials will make scenes and objects look even more realistic. Best if use in conjunction with lights. **Buffering Start/End Notification** - Buffering notification support for videos. Now you can display an awesome [ViroSpinner](doc:virospinner) if your videos buffer! **Additional SceneNavigation Functionality** - Read more about it at [Scene Navigation](doc:scene-navigation). ** New Code Samples ** - Product Showcase and VR Media Player - We just added two more new and awesome code samples with which to play and get started! Check them out here: [Code Samples](doc:code-samples). ### Fixes - Too many to list here, but our platform is now more stable and performs better! If you see anything, feel free to contact us or file an issue at the link at the top of this page. ### Upgrade Instructions For those of you running `react-viro v1.0.0`, the following instructions will guide you through updating your Viro project. 1. In your terminal, run the command `npm update -g react-viro-cli` - this will update your react-viro-cli to the latest and will ensure that you won't need to perform this step every time you do `react-viro init` 2. Change these dependencies in your Viro project's `package.json` file: - react 15.4.2 -> 16.0.0-alpha.6 - react-native 0.41.2 -> 0.43.3 - react-viro 1.0.0 -> 1.1.0 - react-test-renderer 15.4.2 -> 16.0.0-alpha.6 Your package.json dependencies should now look like the following: ``` "dependencies": { "react": "16.0.0-alpha.6", "react-native": "0.43.3", "react-viro": "1.1.0" }, "devDependencies": { "babel-jest": "19.0.0", "babel-preset-react-native": "1.9.1", "jest": "19.0.2", "react-test-renderer": "16.0.0-alpha.6" }, ``` 3. Also in your `package.json` add the following line to the `scripts` section: ` "prestart": "./node_modules/react-viro/bin/run_ngrok.sh",` 4. Simply run `npm install`. Once that completes, you should now be able to use our v1.1.0 features! #react-viro v1.0.0 (Compatible with react-native v0.41.2) This is it! We've launched our v1.0.0 and with it we have Cardboard for Android/iOS, GearVR and Daydream support! We're excited for you to get started developing, so head on over to our website and [sign up](http://www.viromedia.com/signup) for a key to access Viro! p.s. As with all new releases (especially one as grand as this), there may be a few small issues so bear with us as we iron out the kinks. Check out the links at the top of this page if you need to contact us.