Readium Kotlin Toolkit
Readium Mobile is a toolkit for ebooks, audiobooks and comics written in Swift & Kotlin.
This toolkit is a modular project, which follows the Readium Architecture. The different modules are found under readium/.
shared– SharedPublicationmodels and utilitiesstreamer– Publication parsers and local HTTP servernavigator– PlainFragmentandActivityclasses rendering publicationsopds– Parsers for OPDS catalog feedslcp– Service and models for Readium LCP
A Test App demonstrates how to integrate the Readium Kotlin toolkit in your own reading app
Using Readium
Readium modules are distributed through JitPack. It's also possible to clone the repository (or a fork) and depend on the modules locally.
From the JitPack Maven repository
Make sure that you have the $readium_version property set in your root build.gradle and add the JitPack repository.
buildscript {
ext.readium_version = '2.1.1'
}
allprojects {
repositories {
maven { url 'https://jitpack.io' }
}
}
Then, add the dependencies to the Readium modules you need in your app's build.gradle.
dependencies {
implementation "com.github.readium.kotlin-toolkit:readium-shared:$readium_version"
implementation "com.github.readium.kotlin-toolkit:readium-streamer:$readium_version"
implementation "com.github.readium.kotlin-toolkit:readium-navigator:$readium_version"
implementation "com.github.readium.kotlin-toolkit:readium-opds:$readium_version"
implementation "com.github.readium.kotlin-toolkit:readium-lcp:$readium_version"
}
From a local Git clone
You may prefer to use a local Git clone if you want to contribute to Readium, or if you are using your own fork.
First, add the repository as a Git submodule of your app repository, then checkout the desired branch or tag:
git submodule add https://github.com/readium/kotlin-toolkit.git
Next, declare the Kotlin version used in your root build.gradle.
buildscript {
ext.kotlin_version = '1.5.31'
}
Then, add the following to your project's settings.gradle file, altering the paths if needed. Keep only the modules you want to use.
include ':readium:shared'
project(':readium:shared').projectDir = file('kotlin-toolkit/readium/shared')
include ':readium:streamer'
project(':readium:streamer').projectDir = file('kotlin-toolkit/readium/streamer')
include ':readium:navigator'
project(':readium:navigator').projectDir = file('kotlin-toolkit/readium/navigator')
include ':readium:opds'
project(':readium:opds').projectDir = file('kotlin-toolkit/readium/opds')
include ':readium:lcp'
project(':readium:lcp').projectDir = file('kotlin-toolkit/readium/lcp')
You should now see the Readium modules appear as part of your project. You can depend on them as you would on any other local module:
dependencies {
implementation project(':readium:shared')
implementation project(':readium:streamer')
implementation project(':readium:navigator')
implementation project(':readium:opds')
implementation project(':readium:lcp')
}
Building with Readium LCP
Using the toolkit with Readium LCP requires additional dependencies, including the binary liblcp provided by EDRLab. Contact EDRLab to request your private liblcp and the setup instructions.
53 Jul 13, 2022
1 Nov 21, 2021
48.4k Jan 3, 2023
174 Dec 5, 2022
52 Nov 24, 2022
6 Oct 18, 2022
85 Nov 17, 2022
126 Dec 7, 2022
2.3k Jan 3, 2023
28 Dec 21, 2022
596 Dec 31, 2022
1 Dec 4, 2021
0 Dec 28, 2021
4 Aug 2, 2022
3 Aug 1, 2022
2.3k Dec 28, 2022
1.9k Dec 23, 2022
154 Nov 18, 2022