A workspace for on-boarding developers

This workspace is one of the ways you can get started with the R2 Kotlin Projects. It is not the only way and you can pick to setup your developement environment in the way that best fits your needs.

In this workspace you will find 4 Github branches:

You pick this branch if are an integrator and all you need is to quickly get started with the R2 Testapp.

1. git clone --recurse-submodules -b int/testapp https://github.com/readium/r2-workspace-kotlin.git r2-workspace-kotlin
2. in Android Studio Open an existing Android Studio project and select the r2-workspace-kotlin directory
3. run configuration r2-testapp

You pick this branch if are an developer and a R2 contributor. You can get started quickly on the R2 Testapp and it's modules with this branch. We do appreciate any contribution, no matter how small it is, it makes a difference :)

1. git clone --recurse-submodules -b dev/testapp https://github.com/readium/r2-workspace-kotlin.git r2-workspace-kotlin
2. in Android Studio Open an existing Android Studio project and select the r2-workspace-kotlin directory
3. run configuration r2-testapp

You pick this branch if are an integrator and you would like to get started with the R2 Testapp supporting LCP.

1. git clone --recurse-submodules -b int/testapp-with-lcp https://github.com/readium/r2-workspace-kotlin.git r2-workspace-kotlin
2. copy liblcp.aar into the liblcp directory
3. in Android Studio Open an existing Android Studio project and select the r2-workspace-kotlin directory
4. run configuration r2-testapp

You pick this branch if are an developer and a R2 contributor. You can get started quickly on the R2 Testapp and it's modules including LCP with this branch. We do appreciate any contribution, no matter how small it is, it makes a difference :)

1. git clone --recurse-submodules -b dev/testapp-with-lcp https://github.com/readium/r2-workspace-kotlin.git r2-workspace-kotlin
2. copy liblcp.aar into the liblcp directory
3. in Android Studio Open an existing Android Studio project and select the r2-workspace-kotlin directory
4. run configuration r2-testapp

Readium LCP is a DRM. As any protection technology, care must be taken to avoid disclosing too much technical information to the open world without good reasons. This is why EDRLab has chosen to provide a small pre-compiled Readium LCP module to R2 implementers, in two flavors:

1. a "test" grade LCP library, provided after a direct contact between the developer and EDRLab. To get this library, a developer must only provide to EDRLab its company name, web site and basic information about the context of the project involving Readium LCP.
2. a "production" grade LCP library, which simply replaces the "test" library in the project after the development has been fully tested. Go get access to this production module, the client company must be trusted and the Readium LCP Terms of Used must have been signed.

To contact EDRLab, please send an email to contact(at)edrlab.org or use the Readium Slack on the "lcp" channel.