Prerequisites

Follow the prerequisites section from the mindlogger repo, you need Xcode, Cocoapods, etc. You can skip Android, JavaSDK, and running app services locally

Repo: https://github.com/ChildMindInstitute/mindlogger-app-refactor/tree/feat/M2-7443

Branch: feat/M2-7443-unity-item

Note: You can use the Dev Environment (API, Admin, Web) to reduce the local setup required. The .env.dev example below is pointing to the dev API.

RN Unity library: https://github.com/azesmway/react-native-unity

Video: https://www.loom.com/share/d09fa23d30de45f386e6444536846b72

Unity Framework build:

• Follow the instructions from react-native-unity for steps 1-7

• Move the UnityFramework.framework to the project

  • Right click the UnityFramework object and select “Show in Finder”
  • In the mindlogger-app root, create the following folder:
    • unity/builds/ios
  • Drag the entire UnityFramework.framework over to the unity/builds/ios folder

• Before the final step make sure to install all dependencies first

  yarn install
  rm -rf ios/Pods && rm -f ios/Podfile.lock && npx pod-install
  yarn pods:local
  

Admin Panel setup

DEV Admin

Video: https://www.loom.com/share/8c9763316ac14873a67e54221c526565?sid=3074d616-9074-494c-a7c8-2cf6fb52037b

React-Native setup

Edit your .env.dev before beginning

API_URL=https://api-dev.cmiml.net
STORE_ENCRYPTION_KEY=aa11bb22cc33
APP_VERSION=0.0.1
ENV=dev
DEEP_LINK_PREFIX=https://web-dev.cmiml.net
LAUNCHDARKLY_MOBILE_KEY=mob-1a2b3c-1234-abcd-8c60-11aa22bb33cc

Xcode Build:

Around 5:00 in the video

• Open the file ios/MindloggerMobile.xcodeproj in Xcode
• Select a physical device as build target

• Enable Automatically manage signing (1) and select your developer account from the dropdown (2)
  • Rename bundle identifier to an unique value

• Delete incompatible capabilities
  1. Remove Associated Domains2
  2. Disable Background fetch modes
  3. Remove Push Notification

• Click play icon to build and run

• React-native console should automatically open, if it doesn’t run yarn start from the project root
• postMessage and onUnityMessage is in src/entities/unityView/ui/Unity.tsx, edit as necessary
• Changes should automatically sync as you edit and save the file, but you may want to fully close the app if you make significant changes

Retrieving logs with iExplorer

Video: https://www.loom.com/share/662e3a22510d4c4bb64df409ba56b4eb?sid=1e4d09e8-a79b-4a65-9f94-468fd9ab1906