There are two examples provided for the Java bindings:

• A simple GUI (Swing) to allow the user log into MEGA. If login is successfull, it retrieves the MEGA filesystem and lists files/folders in the root folder.
• A simple console example that will demonstrate a simple "CRUD" (create, read, update delete) workflow, using this README file to upload and download. This example uses no GUI, and will display all interactions on the console using the Java provided logging framework.

Below, you will find instructions to generate the required sources and library (prerequisites) for developing a MEGA app in Java. Afterwards, the Example application can be compiled and executed.

1. Download, build and install the SDK

   git clone https://github.com/meganz/sdk
   cd sdk
   sh autogen.sh
   ./configure --enable-java
   make
   

   It might need to be necessary to pass the Java include directory for jni.h to the configure command, e. g.

   --with-java-include-dir=/usr/lib/jvm/java-8-openjdk-amd64/include

2. Copy or symlink the library libmegajava.so into the libs folder in your project.

   mkdir examples/java/libs
   cp bindings/java/.libs/libmegajava.so examples/java/libs/
   # Alternatively for linking:
   ln -s ../../../bindings/java/.libs/libmegajava.so examples/java/libs/.
   

3. Copy or symlink the Java classes into the src folder in your project.

   cp -a bindings/java/nz/mega/sdk examples/java/src/nz/mega/
   # Alternatively for linking:
   ln -s ../../../../../bindings/java/nz/mega/sdk examples/java/src/nz/mega/.
   

You have two options, using a prebuilt native library or building it by yourself.

1. Download and extract the SDK to a folder in your computer (link).
2. Download the prebuilt library (mega.dll) along with its corresponding Java classes from here. Commit: 92cb2b896cfe5ee9d3520cc05641ef248963f3de
3. Extract the content into sdk/examples/java/, keeping the folder structure.

Instead of downloading the prebuilt library, you can build it directly from the sources.

1. Download and extract the SDK to a folder in your computer (link).
2. Follow the instructions in this guide.
3. Copy the new file mega.dll from sdk/bindings/java/contrib/vs2015/Release and its dependencies into sdk/examples/java/libs.
4. Copy the Java classes from sdk/bindings/java/nz/mega/sdk into sdk/examples/java/src/nz/mega/sdk.

At this point, you should have all the required source code and the MEGA library in src and libs folders respectively.

You can simply compile the application and execute it:

```
    mkdir bin
    # For the Java Swing GUI example:
    javac -d bin -sourcepath src/ src/nz/mega/bindingsample/SwingExample.java
    java -cp bin nz.mega.bindingsample.SwingExample

    # For the Java console example (`-D` parameter is to configure logging):
    javac -d bin -sourcepath src/ src/nz/mega/bindingsample/CrudExample.java
    java -cp bin nz.mega.bindingsample.CrudExample
```

Notes:

• If you have problems loading mega.dll, please add the folder that contains that library to your PATH environment variable:

set PATH=%PATH%;<sdkpath>\examples\java\libs

• If setting the PATH environment variable doesn't solve the solve the problem loading the library, you may try moving mega.dll and all its dependencies to the working directory.

• A 64 bit version of all required libraries is provided in the x64 folder inside the libs folder of our package with prebuilt libraries. You can replace the 32-bit DLLs with the 64-bit ones to run the example app in a 64 bit environment. Since all prebuilt libraries are built with Visual Studio 2015, you will need to install the Microsoft Visual Studio 2015 Redistributable Package (32 bit or 64 bit) to use them.

• The console example will not work from some IDEs (like Eclipse) as it requires the hidden password entry using the console directly.

Or you might prefer to use Eclipse:

1. Create a new Java project.
2. Copy src and libs folders into the folder of your project.
3. Build and run the project in Eclipse.

The file nz/mega/sdk/MegaApiJava.java contains JavaDoc documentation. It is recommended to use the MegaApiSwing subclass instead because it makes some needed initialization and sends callbacks to the UI thread, but the documentation in MegaApiJava applies also for MegaApiSwing.