Simplifies managing string resources by fetching from remote sources or using local fallbacks. Supports quick access through caching and offers flexible integration with various storage and network solutions.
Seahorse provides a simple framework to support getting strings from remote sources or fallback to the ones compiled into the app or locally available. The goal is to provide the string as fast as possible, so the framework fetches the remote source and store locally for quick access.
implementation("com.bidyut.tech.seahorse:seahorse-core:<version>")
[versions]
seahorse = "version"
[libraries]
seahorse-core = { group = "com.bidyut.tech.seahorse", name = "seahorse-core", version.ref = "seahorse" }
Minimum requirement for a Seahorse set up requires the fallback source to be present, and we default to English. To get started, create an instance of Seahorse with the system fallback (where available).
For Android, we can fallback to the compiled resources:
val seahorse = Seahorse {
fallbackSource = ResourceFallbackSource(context)
}
For iOS, we can fallback to bundled strings:
let seahorse = Seahorse { c in
c.fallbackSource = NSLocalizedFallbackSource()
}
For platforms that don't have any such provisions we can fallback to a map or other options:
val seahorse = Seahorse {
fallbackSource = MapFallbackSource(
mapOf(
"key" to "basic string",
"parameterisedKey" to "got %s",
)
)
}
Now you can access the string resource for the currently selected language by:
seahorse.getString("key")
or if there is some parameters we can tack along
seahorse.getString("parameterisedKey", "milk")
Remote sources require a local store to cache the strings for quick access. The local store can be a simple map or a more complex database.
We can use a SQLite database for the local store, for example in Android:
val seahorse = Seahorse {
fallbackSource = ResourceFallbackSource(context)
localStore = AndroidDatabaseDriverFactory(context)
}
[libraries]
seahorse-sqlite = { group = "com.bidyut.tech.seahorse", name = "seahorse-sqlite", version.ref = "seahorse" }
And we can pair that up with an Ktor network source:
val seahorse = Seahorse {
fallbackSource = ResourceFallbackSource(context)
localStore = AndroidDatabaseDriverFactory(context)
remoteSource = AndroidKtorNetworkSource { languageId ->
"https://www.bidyut.com/tech/seahorse/sample/${languageId.lowercase()}.json"
}
}
[libraries]
seahorse-ktor = { group = "com.bidyut.tech.seahorse", name = "seahorse-ktor", version.ref = "seahorse" }
There is also provide OkHttp implementation:
val seahorse = Seahorse {
fallbackSource = ResourceFallbackSource(context)
localStore = AndroidDatabaseDriverFactory(context)
remoteSource = OkHttpNetworkSource(okHttpClient) { languageId ->
"https://www.bidyut.com/tech/seahorse/sample/${languageId.lowercase()}.json"
}
}
[libraries]
seahorse-okhttp = { group = "com.bidyut.tech.seahorse", name = "seahorse-okhttp", version.ref = "seahorse" }
Surfaced from shared tags and platforms — no rankings paid for.