Building Processing for Android

Setting up Processing

1. Since we only require processing as a dependency, perform a shallow clone of the processing repo and build it by running ant in the processing/build folder, as detailed in the build instructions for Processing:

git clone https://github.com/processing/processing.git --depth 1

Eclipse

2. Import the repo into Eclipse: Import > Projects from Git > Existing local repository > Select Processing folder > Import existing eclipse project
3. Select:
   • processing-app
   • processing-core
   • processing-java (Select the option with path processing/java)
4. Right click the processing-app project and select Run As > Java Application > “Base - processing.app”

IntelliJ

2. Import the repo into IntelliJ: Import Project > Select Processing folder > Import from external model (Eclipse)
3. In the “Select Eclipse projects to import” window, select
   • processing-app
   • processing-core
   • processing-java (java)
4. Goto Run > Edit Configurations and create a new Application configuration.
   1. Set “Main class” to “Base (processing.app)”
   2. And “Use classpath of module” to “processing-app”

Setting up Processing Android

First of all, download and install the Android SDK. All you need are the command line tools (available at the bottom of this page). Using the command line tools, you can download all the required components of the Android SDK. In order to build the Android mode, you only need to install the Android SDK Tools, the SDK Platform-tools, the Build-tools, and the SDK Platform for Android 8 (API 26).

Eclipse

1. Import Processing Android into Eclipse similarly using Step 2 above.
2. Right click the android-core package > Build Path > Configure Build Path
3. Edit the ANDROID_JAR path and set it to the android.jar file located in the platforms/android-xx folder of your android sdk (where xx is the Android API level).
4. Run the ant command in the processing-android/core folder to build the core library.
5. If you imported processing-vr in Step 1, configure its build path and set the processing-core.zip path to the file now present in the root of your processing-android folder. Also set the ANDROID_JAR path.
6. Add/Edit the Run Configuration to the processing-app needed to load the Android mode from the development repository:
   1. Right click on the processing-app project, and select Run As...|Run Configurations
   2. Create a new run configuration or edit the existing configuration, making sure it has processing-app as the project, and processing.app.Base as the main class.
   3. In the arguments tab, enter -Dusemode=processing.mode.android.AndroidMode:${resource_loc:/android-mode} as VM arguments.
7. Run the “ant dist” command in the processing-android root folder.
8. Start processing-app from the run menu. The Android Mode should now be present in the Mode menu.
9. In order to run a debug session including breakpoints in the source code, add the processing and processing-android folders in the Source tab of Run Configurations dialog.

IntelliJ

1. Go to File > Project Structure > Modules > Add > Import Module > Select Processing-Android folder > Import module from external model (Eclipse) > Select all projects
2. Go to File > Settings > Appearance & Behaviour > Path Variables and set the ANDROIDJAR variable’s(create if not present) value to the android.jar file located in the platforms/android-xx folder of your android sdk (where xx is the Android API level). Also create a new variable called PROC_AND (or anything you want) and set its value to your processing-android folder.
3. Run the ant command in the processing-android/core folder to build the core library first then “ant dist” in the processing-android root folder.
4. Set the VM options parameter of the run configuration to -Dusemode=processing.mode.android.AndroidMode:$VAR$. Replace VAR with the variable you created in step 2 (e.g.: PROC_AND).
5. Run the project. The Android Mode should now be present in the Mode menu.