Skip to content

Commit 5fa2a5d

Browse files
committed
docs: expand Android SDK overview with detailed features and benefits
1 parent 62abe32 commit 5fa2a5d

File tree

1 file changed

+56
-25
lines changed

1 file changed

+56
-25
lines changed

android-sdk/about.mdx

Lines changed: 56 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -5,47 +5,78 @@ slug: /
55
description: Overview of Tolgee Android SDK with Over‑the‑Air (OTA) localization updates and how to get started.
66
---
77

8+
# Tolgee Android SDK
9+
10+
Tolgee is a platform that streamlines translations for web, mobile, and desktop apps. With tools like the SDK, CLI, and REST API, it simplifies in-context translation and string management for efficient internationalization. Explore the docs to get started!
11+
12+
## Overview
13+
814
> NOTE:
915
> For managing static translations in your repository, consider using the [Tolgee CLI](/tolgee-cli/installation).
1016
11-
Tolgee Android SDK lets you localize Android apps with dynamic content delivery, Over‑the‑Air (OTA) translation updates, reactive locale changes, and seamless integration with Views and Jetpack Compose.
17+
Tolgee Android SDK lets you locate Android apps with dynamic content delivery, which adapts content to user behavior, preferences and device data.
18+
19+
Our over‑the‑Air (OTA) translation updates, makes local changes, and seamlessly integrates with multiple systems, Android Views, Jetpack Compose and static translations.
20+
21+
## Why should you try it?
22+
23+
Tolgee lets you ship translation fixes and new languages faster and easier- without a new app build. Our product internationalization teams can push improvements instantly and validate the changes during production.
24+
25+
The platform works offline with caching, backups referencing, providing resource fallbacks, selecting the best resource for a user's device settings and preloading critical namespaces for smooth user experience. Above that Tolgee keeps UX consistent, by updating UI automatically, as a response to local changes. These are what grants fewer untranslated or mismatched strings of text.
26+
27+
## New possibilities
28+
29+
### Over‑the‑Air (OTA) updates
30+
Delivers translations via CDN (Cloud or self‑hosting) with caching, automatic backup referencing.
1231

13-
## Why use it
32+
### Product internationalization teams on your side
33+
Our teams can push improvements instantly and validate the changes during production process.
1434

15-
- __Avoid releases for copy changes__: Ship translation fixes and new languages without a new app build.
16-
- __Faster iteration__: Product/localization teams can push improvements instantly and validate in production.
17-
- __Consistent UX__: UI updates reactively on locale change; fewer stale or mismatched strings.
18-
- __Resilient by default__: Works offline with caching and resource fallbacks; fewer blank strings.
35+
### Change the app's language at runtime (Runtime locale API)
36+
While switching locations our program reacts instantly with Tolgee.changeFlow function.
1937

20-
## What you can do
38+
### Works offline with fallbacks and preloading
39+
Provides android resources fallback, selecting the best resource for a user's device settings and preloading critical namespaces.
2140

22-
- __Over‑the‑Air (OTA) updates__: Deliver translations via CDN (Cloud or self‑host) with caching.
23-
- __Views and Compose support__: `stringResource`/`pluralStringResource`, parameters, and reactive updates.
24-
- __Runtime locale API__: Switch locales and react to `Tolgee.changeFlow`.
25-
- __Fallbacks and preloading__: Android resources fallback; preload critical namespaces/locales.
26-
- __Hosting options__: Tolgee Cloud CDN or your own CDN.
41+
### Consistent UX
42+
Our platform keeps UX consistent, by updating UI automatically, as a response to local changes.
43+
44+
### Support for Android Views, Jetpack Compose and static translations with CLI
45+
Aids with both coding functions stringResource, pluralStringResource and reactive updates.
46+
47+
### Hosting options
48+
Tolgee gives you multiple hosting options: Cloud CDN (Cloud or self‑hosting) or your own CDN.
49+
50+
Our product makes sure to ship translation fixes and new languages faster and easier. Our teams can push improvements instantly and validate the changes during production.
51+
52+
We help your programmers! We support multiple systems, hosting options without a new app build, at that.
53+
54+
Our choice of providing you with fallbacks, caching, reactive updates and preloading grants fewer untranslated or mismatched strings of text and makes the user experience smoother.
2755

2856
## Demo apps
2957

30-
- __Android Views demo__: https://github.com/tolgee/tolgee-mobile-kotlin-sdk/tree/master/demo/exampleandroid
31-
- __Jetpack Compose demo__: https://github.com/tolgee/tolgee-mobile-kotlin-sdk/tree/master/demo/examplejetpack
58+
- **Android Views demo**: https://github.com/tolgee/tolgee-mobile-kotlin-sdk/tree/master/demo/exampleandroid
59+
- **Jetpack Compose demo**: https://github.com/tolgee/tolgee-mobile-kotlin-sdk/tree/master/demo/examplejetpack
3260

3361
## Compatibility
3462

3563
> NOTE:
36-
> Build configuration examples use Kotlin DSL (`build.gradle.kts`). Groovy DSL may work but is not officially supported/tested.
64+
> To build configuration examples use Kotlin DSL (build.gradle.kts). Groovy DSL may work but is not officially supported/tested.
3765
3866
## Get started
3967

40-
- __Installation__: Set up dependencies and network security — [Installation](./installation.mdx)
41-
- __Modules overview__: Choose between Core and Compose — [Modules overview](./modules.mdx)
42-
- __Jetpack Compose__: Install, use, and troubleshoot — [Installation](/android-sdk/jetpack/installation), [Usage](/android-sdk/jetpack/usage), [Troubleshooting](/android-sdk/jetpack/troubleshooting)
43-
- __Usage with Views (non‑Compose)__: Simple keys, parameters, plurals, preloading, reactive flows — [Usage](./usage.mdx)
44-
- __Production guide__: Over‑the‑Air (OTA) updates, caching, formatting, testing — [Production guide](./production.mdx)
45-
- __Troubleshooting__: Common issues and diagnostics — [Troubleshooting](./troubleshooting.mdx)
68+
- **Installation**: Set up dependencies and network security — [Installation](./installation.mdx)
69+
- **Modules overview**: Choose between Core and Compose — [Modules overview](./modules.mdx)
70+
71+
### Choose your system:
72+
73+
- **Jetpack Compose**: Install, use, and troubleshoot — [Installation](/android-sdk/jetpack/installation), [Usage](/android-sdk/jetpack/usage), [Troubleshooting](/android-sdk/jetpack/troubleshooting)
74+
- **Android Views**: Simple keys, parameters, plurals, preloading, reactive flows — [Usage](./usage.mdx)
75+
- **CLI**: Generate and manage static translations — [Tolgee CLI](/tolgee-cli/installation)
76+
77+
- **Production guide**: Over‑the‑Air (OTA) updates, caching, formatting, testing — [Production guide](./production.mdx)
4678

47-
## Next steps
79+
### Additionally see:
4880

49-
- Install and configure the SDK: [Installation](./installation.mdx)
50-
- Connect your app to the Tolgee Platform and manage translations collaboratively: [Platform docs](../platform/)
51-
- Generate or manage static strings with CLI: [Tolgee CLI](/tolgee-cli/installation)
81+
- **Manage translations collaboratively**: Connect your app to the Tolgee Platform — [Platform docs](../platform/)
82+
- **Troubleshooting**: Common issues and diagnostics — [Troubleshooting](./troubleshooting.mdx)

0 commit comments

Comments
 (0)