theta-client-react-native/README.md

This library provides a way to control RICOH THETA using.

## How to create React Native project

### Prerequisite

* Build theta-client.

  ```shell
  $ gradlew publishToMavenLocal podPublishXCFramework
  ```

* Set the directory of theta-client to environment variable `THETA_CLIENT`.

  ```shell
  $ export THETA_CLIENT=<path to theta-client>
  ```

* Build react-native wrapper

  ```shell
  $ cd react-native
  $ sh ./mkpackage.sh
  ```


* Install react-native

### Creating a project

* Create a project using `react-native-cli`, then add theta-client.

  ```shell
  $ npx react-native init YourProject --template react-native-template-typescript
  $ cd YourProject
  $ yarn add $THETA_CLIENT/react-native/package
  ```

* Settings on android

  * YourProject/android/build.gradle
	* set `minSdkVersion` to 26 or later.

* Settings on iOS
  * YourProject/ios/Podfile
	* Set `platform :ios` to '15.0' or later.
	* Add pod of theta-client.
	```
	pod "THETAClient", :path => ENV["THETA_CLIENT"] + "/kotlin-multiplatform/build/cocoapods/publish/debug"
	```

* Building and execution

  ```
  $ cd YourProject
  $ yarn install
  $ yarn run android

  OR

  $ yarn run ios
  ```

  You can execute metro bundler on other terminal in advance.

  ```
  $ yarn start
  ```

### Tips for Windows 11

* Convert your `mkpackage.sh` file from Carriage Return Line Feed "CRLF" to Line Feed "LF"
* Instead of running `sh mkpackage.sh` use `bash mkpackage.sh`