Get Started

Last updated 5 months ago

This section will help you walk through the minimum required setup to run MSTORE project.

Requisite setup

First, this is important, please make sure you have already install and run the simulator successful base on this guide - https://facebook.github.io/react-native/docs/getting-started.html, it will help you install and build your first Example React Native app. If you start with the Expo project please select "Quick Start", and if you start with "Pro version" you should start with "Building Projects with Native Code"

Video Guide

Note: Videos guide don't contain environment setup walkthrough. Read install instructions section below for more details.

Quick Install (Pro version)

MSTORE was built on React Native framework. To run MSTORE, you need to install React Native, please back to "Requisite Setup" before go to this section

Extract the project source code to your workspace. Go to the root folder of the Pro version (mstore-pro)

iOS setup (Mac OS only)

Open command prompt and run the following command, you can use for both Expo & Pro version:

npm run setup
// or run yarn, this is similar to Yarn but could be faster
// install Yarn from https://yarnpkg.com
yarn setup

Android setup

This is command prompt is used for Pro version

// Step 1:
npm install
// or run yarn below, this is similar to Yarn but could be faster
// install Yarn from https://yarnpkg.com
// run the script after install: yarn install
// Step 2: open your simulator by using Genymotion or Android Studio
// Please see the detail setup from Requisite setup
// To check the Android device is ready or not, run: adb devices
// Step 3:
react-native link
react-native run-android

Quick Install (Expo version)

Extract the project source code to your workspace. Go to the root folder of the Expo version (mstore-expo)

Install Expo XDE

XDE stands for Expo Development Environment. It is a standalone desktop app that includes all dependencies you’ll need to get started.

Download the latest version of Expo XDE from: https://expo.io/tools

Expo also release the new tool Expo Dev Tools (beta) which is quite better performance, https://blog.expo.io/announcing-expo-dev-tools-beta-c252cbeccb36

Mobile Client: Expo for iOS and Android

The Expo client is like a browser for apps built with Expo. When you boot up XDE on your project it generates a unique development URL for you, and you can access that from the Expo client on iOS or Android, either on a real device or in a simulator.

On your device: download for Android from the Play Storeor for iOS from the App Store

You don’t need to manually install the Expo client on your emulator/simulator, because XDE will do that automatically.

Project installing

Then the script to create the node_modules folder: yarn install or npm install

Open the XDE and open the project folder, then you can run the project on simulator by click to Device, open on iOS Simulator or Open on Android.

XDE tools

This is other way to run the project via terminal:

// Step 1:
npm install
// or run yarn below, this is similar to Yarn but could be faster
// install Yarn from https://yarnpkg.com
// run the script after install: yarn install
// Step 2:
exp start
// Step 3:
exp android

Note for Window OS (only): if you have issue with the react-native-pod component, please try to open the package.json and remove the line where content "react-native-pod", then re-install again.