BUILDING

Pick one of I-a or I-b below, then move onto II.

I-a. Building with pre-built dependencies.
  - Set the environment variable PROJECT to one of bVNC, aSPICE, or aRDP.

    export PROJECT=bVNC
    ./eclipse_projects/download-prebuilt-dependencies.sh
    ./eclipse_projects/bVNC/copy_prebuilt_sqlitegen_files.sh $PROJECT  

I-b. Building from scratch and working in Eclipse.

0. On Linux, install Eclipse Neon for Android Developers and ADT Plugin.
   a) Point Eclipse at a valid Android SDK installation location.
   b) Install ADT Plugin:
      Help > Install New Software.
      Click Add, in the top-right corner.
      In the Add Repository dialog, name it ADT Plugin and specify location to be
        https://dl-ssl.google.com/android/eclipse/

1. Install sqlitegen into Eclipse.
   a) Download sqlitegen plugin v0.1.19 from:
      https://github.com/iiordanov/sqlitegen-secure/releases/download/v0.1.19/sqlitegen_eclipse_site_0.1.19.jar

      NOTE: Using an older version of the plugin may not work because
      of the switch to the sqlcipher release of sqlite.

   b) Help -> Install New Software
   c) Add -> Archive
   d) Browse to the downloaded jar file and select it.
   e) Give it a name and click OK
   f) Select "Uncategorized"
   g) Click Next and follow the installation process.
   h) Restart Eclipse.

2. Install at least the following dependencies on your Linux machine:
   cmake automake libtool intltool gtk-doc-tools gnome-common gobject-introspection nasm

3. To build bVNC, aSPICE, or aRDP

   - Set the environment variable PROJECT to one of bVNC, aSPICE, or aRDP.
     Set the environment variable ANDROID_NDK to the path to your Android NDK/.

     then run a build script. E.g.:

     export PROJECT=bVNC
     export ANDROID_NDK=/path/to/your/android/NDK/
     export ANDROID_SDK=/path/to/your/android/SDK/

     export PATH=$PATH:${ANDROID_NDK}
     export PATH=$PATH:${ANDROID_SDK}/platform-tools/
     export PATH=$PATH:${ANDROID_SDK}/tools
     ./eclipse_projects/bVNC/prepare_project.sh $PROJECT $ANDROID_NDK

   - Follow the instructions that the script outputs.


II. Importing projects into Eclipse.

1. Import android-support-v7-appcompat project into Eclipse
   - Eclipse->Import->Existing Android Code Into Workspace.
   - The AppCompat project is found here:
       /path/to/android-sdk/extras/android/support/v7/appcompat/
   - You may have to switch the Android Build Target to API 23 or newer
     by (Right-clicking on the project)->Properties->Android

2. Import all projects under eclipse_projects into Eclipse.
   Add bVNC, ZoomerWithKeys, PubkeyGenerator, and FreeRDPCore projects.

   The bVNC, ZoomerWithKeys, and PubkeyGenerator are in the
   bVNC/eclipse_projects/ directory. Add them to Eclipse as existing Android
   projects.

   If building from scratch (I-b above), right-click on the bVNC project and
   ensure SQLiteGen Annotation Processing is enabled.

   The FreeRDP project was downloaded automatically as part of the build process,
   and a symlink was made to it in bVNC/eclipse_projects/.

   Some modifications are needed to the freeRDPCore project in part because
   it is set up to be developed under the ADT IDE.

   - Import eclipse_projects/FreeRDP/client/Android/Studio/freeRDPCore
     into Eclipse as "Existing Android Code". Name the project FreeRDPCore
     by clicking "New Project Name" before clicking "Finish".

   - In the Project Properties, change Project Build Target to Android 7.0+

   - Also there, make sure Android->Is Library checkbox is checked.

   - Also there, click Add to a reference to the AppCompat project (from 2)

   - Also there, change Java Compiler -> Enable project specific settings -> 
     Compiler compliance level to 1.7.

   - Clean and rebuild the project.

3. Ensure ZoomerWithKeys, PubkeyGenerator, FreeRDPCore, and android-support-v7-appcompat
   projects are:
   - Called exactly as written here by right-clicking on each of them,
     then selecting Refactor->Rename

   - Added as as Library References to bVNC (right-click on the bVNC project
     and select Properties -> Android -> Library). If they are not - add them.

   - Are specified as "Required projects on the build path" (right-
     click on the bVNC project, and select Properties -> Java Build
     Path -> Projects). If they are not, add them.

   - Are referenced in Properties -> Project References (put checkmarks on projects).