SALSA on Android

Prerequisites

--------------

1. Java installation
2. SALSA resources
3. Android SDK

RESOURCES PROVIDED

--------------------------

The following resources are available at this link:

1. SALSA source zip file (Salsa_RSH.zip)
2. SALSA jar file (salsa_RSH_2.jar)
3. Android theater source zip file (AndroidTheaterStudio.zip)
4. SALSA demo applications zip file (my_tests.zip)
5. Android theater APK file (AndroidTheater_RSH.apk)

READING

----------

1. You will be running a universal naming service and theaters (that act as actor hosts) in order to deploy SALSA applications on Android. To understand what universal naming service and theaters are, along with how SALSA actors can be deployed remotely, please read chapter 4 in this pdf

INSTALLATION STEPS

------------------------

1. Before proceeding, you should be able to run a simple HelloWorld application in SALSA, on your workstation, using the steps described at this link.
2. Obtain the salsa jar file either by downloading it from SALSA website, downloading it from resources provided or rebuilding it (see section V for rebuilding steps).
3. Set CLASSPATH variable to the path containing the SALSA jar file (salsa_RSH_2.jar).
4. You can either use the provided AndroidTheater application APK to directly run the SALSA host on Android or follow steps in section VI below to generate a custom APK file. The following steps assume you have the Android APK file to deploy to your mobile.
5. Connect your phone to workstation via USB and enable debugging on Android phone (Settings -> Status -> About Phone -> Tap on "Build number" 7 times). Then go to Status -> Developer options and enable "Android debugging"
6. Go to folder where the android theater APK is located and run the following commands:
   1. adb -d install -r AndroidTheater_RSH.apk
   2. adb -d shell am start -n com.example.androidtheater5/.MainActivity
7. Find the Android phone IP address (Settings -> About phone -> Status -> IP address). Note that the theater is configured to listen on port 4040.
8. From the workstation, run the name server on the workstation by running the following command:
   1. java -cp "./*:$CLASSPATH:." wwc.naming.WWCNamingServer -p 3030 > ./namesever_temp.txt
9. From the workstation, run the SALSA application on the mobile using the following command:
   1. java -cp salsa_RSH_2.jar:. -Duan=uan://<workstationIP>:3030 -Dual=rmsp://<mobileIP>:4040 demo1.HelloWorld

REBUILD SALSA JAR FILE

----------------------------

1. Extract contents of [SALSA sources](Salsa_RSH.zip)
2. Go to the home folder
3. Do any modifications or instrumentation as needed.
4. Run the following:
   1. ./buildsalsa
   2. ./buildjar

REBUILD ANDROID THEATER APP

-------------------------------------

1. Extract contents of Android theater sources (AndroidTheaterStudio.zip)
2. Open the project in Android studio
3. If needed, replace the demo1.jar file in app/libs folder with a different demo jar file generated from steps in section VII
4. Rebuild the application in Android studio
5. Rebuild the APK file which will be available at app/build/outputs/apk

UPDATE DEMO SALSA JAR FILE

----------------------------------

1. Extract contents of SALSA demo sources (my_tests.zip)
2. Go to the home folder of my_tests
3. Run the following to generate a jar file for corresponding demo application:
   1. jar cf demo1.jar demo1
   2. Check the program works by running "java -cp $CLASSPATH:demo1.jar demo1.HelloWorld"

TROUBLESHOOTING

----------------------

<TODO>