Download

SDK releases

Upgrade to SDK 4.0

SDK 4.0 moved the book classes and the core-common helpers to new packages, and Katari no longer loads extensions built with SDK 3.x. Every extension needs a rebuild, and only one that uses those classes needs a code change.

Build against 4.0 #

Move the SDK to sdk-4.0.0 and start the release count over at 4.0.0, as Version numbers describes.

build.gradle.kts
defaultConfig {
    versionCode = 9
    versionName = "3.0.2"
    versionCode = 10
    versionName = "4.0.0"
}

dependencies {
    compileOnly("com.github.pa2x2.katari:entry-source-api:sdk-3.0.0")
    compileOnly("com.github.pa2x2.katari:entry-source-api:sdk-4.0.0")
}

In your store's index, set the extension's extensionLib to "4.0" along with its new version, as The index describes.

Fix what no longer compiles #

Book classes come from app.katari.book.api

The package mihon.book.api is now app.katari.book.api, with the same classes and subpackages in it. Change the imports; nothing else in a book source changes. More in Books.

Kotlin
import mihon.book.api.BookCatalogCoverage
import mihon.book.api.BookContentDescriptor
import mihon.book.api.BookResourceAvailability
import app.katari.book.api.BookCatalogCoverage
import app.katari.book.api.BookContentDescriptor
import app.katari.book.api.BookResourceAvailability

Helpers come from app.katari.core.common

The supporting library's package mihon.core.common is now app.katari.core.common. An extension that uses JsonObject.EMPTY or another of its helpers changes the import.

Kotlin
import mihon.core.common.extensions.EMPTY
import app.katari.core.common.extensions.EMPTY

The SDK changelog lists every change in 4.0.