Home

Awesome

MEGA SDK - Client Access Engine <a href="https://scan.coverity.com/projects/4315"><img alt="Coverity Scan Build Status" src="https://scan.coverity.com/projects/4315/badge.svg"/></a>

MEGA --- The Privacy Company --- is a Secure Cloud Storage provider that protects your data thanks to end-to-end encryption. We call it User Controlled Encryption, or UCE, and all our clients automatically manage it.

All files stored on MEGA are encrypted. All data transfers from and to MEGA are encrypted. And while most cloud storage providers can and do claim the same, MEGA is different – unlike the industry norm where the cloud storage provider holds the decryption key, with MEGA, you control the encryption, you hold the keys, and you decide who you grant or deny access to your files.

This SDK brings you all the power of our client applications and let you create your own or analyze the security of our products. Are you ready to start? Please continue reading.

SDK Contents

In this SDK, you can find our low level SDK, that was already released few months after the MEGA launch, a new intermediate layer to make it easier to use and to bind with other programming languages, and example apps for all our currently supported platforms (Windows, Linux, OSX, Android and iOS).

In the examples folder you can find example apps using:

  1. The low level SDK:
  1. The intermediate layer:

MEGAcmd, a higher level command line application that uses the SDK to provide interactive and scriptable access to MEGA. You can use it by running megacmd-server and talk to it from PHP/Python code, for instance.

How to build the SDK library

For the SDK development and compilation we mainly use CMake as the cross-platform project configuration tool. We also use VCPKG to manage the required dependencies to build the SDK in most platforms: Windows, MacOS and Linux.

The prior autotools and qmake build systems are still available but obsolete, so their usage is discouraged.

Building tools

Some common development tools should be available in the system to be able to build the MEGA SDK and the needed dependencies:

Windows

Ensure you have installed Visual Studio, with the necessary components for building C++ sources, and the Windows SDK on your system:

MacOS

Xcode and the Developer tools are needed. To install the Developer tools, run the following command and follow the instructions:

$ xcode-select --install

The following packages should be available in the system as well:

You can use any package manager if you have one installed or build and install them from sources

Linux

For debian-based distributions, you can install the needed compilers and tools using the following command:

sudo apt install build-essential curl zip unzip autoconf autoconf-archive nasm

Package names may vary for other Linux distros, but it should build successfully with similar packages to the ones listed above.

Prepare the sources

First of all, prepare a directory of your choice to work with the MEGA SDK. The mega directory will be used as the workspace directory in the examples in this document.

mkdir mega
cd mega

Then, clone the MEGA SDK repository to obtain the source code for the MEGA SDK.

git clone https://github.com/meganz/sdk

Next to the MEGA SDK, clone the VCPKG repository. If you are already using VCPKG and have a local clone of the VCPKG repository, you can skip this step and use the VCPKG you already have in your system.

git clone https://github.com/microsoft/vcpkg

Note: VCPKG local repository needs to be updated from time to time. If never done, it will eventually fail to find new dependencies or others updated to versions newer than what it already had. The solution is simple: go to VCPKG local repository and run git pull.

Configuration

The following instructions are for configuring the project from the CLI, but cmake-gui or any editor or IDE compatible with CMake should be suitable if the same CMake parameters are configured.

The SDK is configured like any other regular CMake project. The only parameter that is always needed is the VCPKG directory to manage the third-party dependencies. To configure the SDK with the default options, from the workspace (mega directory), run CMake:

cmake -DVCPKG_ROOT=vcpkg -DCMAKE_BUILD_TYPE=Debug -S sdk -B build_dir

Note: The -DCMAKE_BUILD_TYPE=<Debug|Release> may not be needed for multiconfig generators, like Visual Studio.

In the command above, relative paths have been used for simplicity. If you want to change the location of VCPKG, the SDK or the build directory, simply provide a valid relative or absolute path for any of them.

During the configuration of the project, VCPKG will build and configure the necessary libraries for the platform. It may take a while on the first run, but once the libraries are built, VCPKG will retrieve them from the binary cache.

Some options to configure the SDK library can be found in the sdklib_options.cmake file, like ENABLE_SYNC or USE_PDFIUM. The options to manage the examples and tests are in the CMakeLists.txt.

Building the sources

Once the MEGA SDK is configured, simply build the complete project:

cmake --build build_dir

You can specify --target=<target> like SDKlib or megacli, or just leave the command as it is to build all the tagets. Additionally, -j<N> can be added to manage concurrency and speed up the build.

Once the build is finished, binaries will be available in the build_dir

Run megacli

To run the example app megacli, go to the examples directory in the build_dir and execute the megacli binary.

Minimum supported OS versions

Android

DMS

GNU/Linux

iOS

macOS

Windows

Usage

The low level SDK doesn't have inline documentation yet. If you want to use it, please check our example app examples/megacli.

The intermediate layer has been documented using Doxygen. The only public header that you need to include to use is include/megaapi.h. You can read the documentation in that header file.

Additional info

Folder syncing

In this version, the sync functionality is limited in scope and functionality:

megacli on Windows

The megacli example is currently not handling console Unicode input/output correctly if run in cmd.exe.

Filename caveats: Please prefix all paths with \\?\ to avoid the following issues:

Also, disable automatic short name generation to eliminate the risk of clashes with existing short names.