Skip to main content

Installation

In this section, we will see how to clone the project and launch the tutorial application.

1. Clone the project

To begin, you need to clone the tutorial project. To do so, open a terminal and run the following command:

git clone git@github.com:icure/icure-medical-device-react-native-app-tutorial-template.git

Alternatively, create a repository from the tutorial template (More information here).

2. Install dependencies

Once the project is cloned, you need to install the project dependencies. To do so, open a terminal and run the following command:

yarn

3. Install pods (iOS only)

If you want to run the application on iOS, you need to install the pods. To do so, open a terminal and run the following command:

yarn run pod-install

In case of issue with pod installation

During the writing of this tutorial, we encountered an issue with pod installation.

Your Ruby version is X.X.X, but your Gemfile specified X.X.X

If you installed XCode on your machine, it is possible that it installed as well a version of Ruby which is not compatible with the version required by ReactNative. If that's the case, the following error will output when executing the pod-install yarn command: Your Ruby version is X.X.X, but your Gemfile specified X.X.X.

In this case, we suggest using RVM or rbenv to install a version of Ruby required by the project.

Once the Ruby version is installed, you will have to install the pods by using this additional command:

cd ios && bundle install && cd ..
yarn run pod-install

version X.X.X is not installed

It is also possible that you don't have the Ruby version used by the tutorial project (See file .ruby-version) installed on your machine. You will therefore have the error rbenv: version 'X.X.X' is not installed.

To resolve this issue, use RVM or rbenv to install the required Ruby version.

pod: command not found

When trying to install your pods, you can also get the error pod: command not found. To resolve this issue, you have to install the cocoapods gem using: sudo gem install cocoapods.

Could not find ... in locally installed gems

Pod-install command can also leads you to a similar error message: Could not find cocoapods-1.11.3, ... in locally installed gems.

To resolve this issue, you will have to install the bundle manually to install the missing gems. For this, execute the following command:

cd ios && bundle install && cd ..

4. Launch the application

Once the dependencies are installed, you need to launch the application to verify that everything is correct. To do so, open a terminal and run the following command:

yarn run ios

Let's now configure your first iCure solution.