To get started, have sword checked out at the same level as bishop, e.g.,

~/src/sword
~/src/bishop

##########  Prepare SWORD Cordova plugin ###############################
cd ~/src/sword/bindings/java-jni
make
cd ../Android
# run Android Studio and open project ~/src/sword/bindings/Android/SWORD
# once project is loaded, choose Build | Rebuild Project
# this will build the native libsword.so binaries for Android
# once building is complete, continue in shell...
make

# on iOS, build the cordova plugin libsword.so
# run Xcode and open project ~/src/sword/bindings/objc/SWORD/SWORD.xcodeproj
# select Product | Build
# then copy the universal libsword.so binary and deps with..
cd ~src/sword/bindings/objc
make


 
##########  Build bishop ###############################

###### Prerequisite #########################
# bishop is a cordova application
# prerequisite to compiling bishop is to have
# cordova successfully installed
# something like:
#
#   yum install npm
#   npm -g i cordova
#
# but see this link 
# https://cordova.apache.org/docs/en/latest/guide/cli/
#
# on iOS we use cordova-icon and cordova-splash to generate
# the plethora of required images.  You'll need to install
# these with something like:
#
#   npm -g -i cordova-icon
#   npm -g -i cordova-splash
#
# but see these links:
# https://github.com/AlexDisler/cordova-icon
# https://github.com/AlexDisler/cordova-splash
#


######## first time setup of bishop project after checkout ######################
# edit Makefile and choose target Android or iOS at the beginning of the Makefile
# then setup the project for your environment with
make setup

# to build 
make

# for iOS, the cli make doesn't complete successfully for me and
# it is necessary to finish the build in Xcode.
# Open in Xcode
# ~/src/bishop/platforms/ios/Bishop.xcodeproj
# then Product | Destination | [choose a simulator for testing]
# then Product | Build
# then the little VCR play button will run in emulator
#
# A nice feature of Safari in macOS is that it has a menu choice
# to attach to running iOS emulators and will allow you to debug
# the JavaScript in Bishop.

# for testing in Android
# and possibly iOS
make run

# if no phone is plugged in an emulator will be launched
# if your phone is plugged in, check to see that you can
# access it with something like:
adb devices #should show your phone
adb logcat #should tail the debug log on your phone

# if you don't have permission, you'll probably need to
# find the usb bus and dev of your phone and then:
sudo chmod 666 /dev/bus/usb/$bus/$dev
adb kill-server #restarts the adb server after permission change

# to simply install
make install


#########  Deploy Apple
#
# XCode: Product | Destination | Generic iOS Device
#	Product | Archive | Export... | Ad Hoc