Readium Swift 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.
Publicationmodels and utilities
R2Streamer– Publication parsers and local HTTP server
UIViewControllerclasses rendering publications
ReadiumOPDS– Parsers for OPDS catalog feeds
ReadiumLCP– Service and models for Readium LCP
A Test App demonstrates how to integrate the Readium Swift toolkit in your own reading app
The Test App contains examples on how to use all these dependency managers.
Swift Package Manager
From Xcode, open File > Add Packages and use Readium’s GitHub repository for the package URL:
You are then free to add one or more Readium libraries to your application. They are designed to work independently.
If you’re stuck, find more information at developer.apple.com.
Add the following to your
github "readium/swift-toolkit" ~> 2.2.0
Then, follow the usual Carthage steps to add the Readium libraries to your project.
Note that Carthage will build all Readium modules and their dependencies, but you are free to add only the ones you are actually using. The Readium libraries are designed to work independently.
Refer to the following table to know which dependencies are required for each Readium library.
Add the following
pod statements to your
Podfile for the Readium libraries you want to use:
pod 'R2Shared', podspec: 'https://raw.githubusercontent.com/readium/swift-toolkit/2.2.0/Support/CocoaPods/ReadiumShared.podspec' pod 'R2Streamer', podspec: 'https://raw.githubusercontent.com/readium/swift-toolkit/2.2.0/Support/CocoaPods/ReadiumStreamer.podspec' pod 'R2Navigator', podspec: 'https://raw.githubusercontent.com/readium/swift-toolkit/2.2.0/Support/CocoaPods/ReadiumNavigator.podspec' pod 'ReadiumOPDS', podspec: 'https://raw.githubusercontent.com/readium/swift-toolkit/2.2.0/Support/CocoaPods/ReadiumOPDS.podspec' pod 'ReadiumLCP', podspec: 'https://raw.githubusercontent.com/readium/swift-toolkit/2.2.0/Support/CocoaPods/ReadiumLCP.podspec'
Take a look at CocoaPods’s documentation for more information.
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/swift-toolkit.git
Next, drag and drop the whole
swift-toolkit folder into your project to import Readium as a Swift Package.
Finally, add the Readium libraries you want to use to your app target from the General tab, section Frameworks, Libraries, and Embedded Content.
Building with Readium LCP
Using the toolkit with Readium LCP requires additional dependencies, including the framework
R2LCPClient.framework provided by EDRLab. Contact EDRLab to request your private
R2LCPClient.framework and the setup instructions.