peer.ai

Table of Contents

• Chapter 1 - About
• Chapter 2 - Setup
• Chapter 3 - Troubleshooting

Chapter 1 - About

• About
  • peer.ai is a Proof of Concept hybrid app being built with React Native on the peerism protocol.
• Resources
  • Waffle board: https://waffle.io/peerism/peer.ai/join
  • Trello: https://trello.com/peerism
  • Discord: https://discord.me/peerism
• Technology stack:
  • React Native
  • React Native CLI
  • Homebrew
  • Node Version Manager
  • Yarn
  • Node.js - JavaScript runtime to build JavaScript code.
  • Watchman
  • Xcode and Xcode Command Line Tools (CLT)
  • Android Studio

Chapter 2 - Setup

• Bash (Unix shell) on macOS
  • Install dependencies
    • Install Node Version Manager (NVM)
    • Install latest stable version of Node.js using NVM (includes NPM), switch to using, and check where installed

        nvm install v8.0.0; nvm use v8.0.0; nvm list; which node;
      

    • Update PATH by appending Node Package Manager (NPM) binary to end of Bash Profile config and reset shell environment

        echo 'export PATH="/usr/local/share/npm/bin:$PATH"' >> ~/.bash_profile; source ~/.bash_profile
      

    • Install Watchman

        brew install watchman; brew upgrade watchman; which watchman
      

    • Install React Native CLI globally and update package.json

        cd PeerAI; yarn add global react-native-cli; yarn add react-native
      

    • Install Yarn and NPM dependencies

        cd PeerAI; yarn install --verbose; npm install --verbose
      

  • Simulation
    • iOS
      • Install Xcode and Xcode Command Line Tools (CLT)
      • Show React Native iOS Emulation Help

          react-native run-ios --help
        

      • Check that you are in the PeerAI app root directory:

          cd PeerAI
        

      • Create/select iOS Simulator Devices within Xcode

          open ios/PeerAI.xcodeproj
        

      • List iOS Simulator Device Types

          ios-sim showdevicetypes
        

      • Run Emulator (within PeerAI root directory) in iOS Simulator.

          react-native run-ios
        

        

    • Android
      • Install Android Studio
      • Check that you are in the PeerAI app root directory:

          cd PeerAI
        

      • Install Android Target Platforms using Android SDK Manager

          android
          android --help
        

      • List Available Targets

          android list targets
        

      • Create Android Virtual Device image using a target that had a Tag (i.e. android create avd -n <name> -t <target> --abi default/x86_64). Note: Devices stored in ~/.android/avd/.android/avd/

          android create avd -n "react" -t "android-N" --abi default/x86_64
        

      • Show list of Android Virtual Devices

          android list avd
        

      • Configure Virtual Device details using Android Virtual Device (AVD) Manager

          android avd
        

      • Open and perform in Terminal Window #2
        • Boot of Android Device using configured Platform (i.e. emulator -avd <name>)

            emulator -avd "react"
          

      • List Devices

          react-native run-android --help
          adb devices
        

        • Sample output:

            $ adb devices
            List of devices attached
            emulator-5554	device
          

      • Delete previous build

          rm android/app/build/outputs/apk/app-debug.apk
        

      • Run React Native app using the Emulator you have already booted up (within PeerAI root directory)

          react-native run-android --deviceId "emulator-5554"
        

        

  • Debugging
    • Common
      • https://facebook.github.io/react-native/docs/debugging.html
      • Chrome Browser

          open http://localhost:8081/debugger-ui
        

    • iOS
      • (CMD + Shift + K) Hardware > Connect Hardware Keyboard
      • (CMD + D) In-App Developer Menu
    • Android
      • (CMD + M) In-App Developer Menu

Chapter 3 - Troubleshooting

• Troubleshooting
  • http://facebook.github.io/react-native/releases/0.19/docs/troubleshooting.html
• Remediation Measures
  • Kill React Native server on default port of 8081

      kill $(lsof -t -i:8081)
    

    OR

      sudo lsof -n -i4TCP:8081 | grep LISTEN
      kill -9 <cma process id>
    

  • Remove iOS and/or Android build directory, then rebuild

      cd PeerAI
      rm -rf ios/build/
      rm -rf android/build/