Devnagri Over the Air for Android lets you update translations in your Android app without having to release it every single time.
By including our SDK, your app will check for updated translations in Devnagri regularly and download them in the background.
Do note: The language selection screen needs to be designed by the client. We only empower localisation of the app.
As a first step a new maven repository needs to be added to your default dependency resolution file set by your project, it can be either your project build.gradle file or settings.gradle file:
repositories {
...
maven { url 'https://jitpack.io' }
}
Add the below dependency in your app build.gradle file:
dependencies {
...
implementation ('com.github.DevnagriAI:dota-sdk-android:1.0.9@aar') { transitive(true) }
}
Use Kotlin version 1.4.30 or above and Gradle JDK version 11. This SDK support only kotlin language. Target/Compile SDK should be 31.
Initialise the SDK in your application class and add the API_KEY from DevNagri.
class MainApplication : Application() {
override fun onCreate() {
super.onCreate()
val syncTime:Int = 10 //In minutes
val strings = R.string::class.java.fields.map { it.name }
val arrays = R.array::class.java.fields.map { it.name }
val plurals = R.plurals::class.java.fields.map { it.name }
// passing arrays and plurals in init method is optional here, pass them only if defined in strings.xml file
DevNagriTranslationSdk.init(applicationContext, "API_KEY" ,syncTime, strings, arrays, plurals)
}
}
Additionally, you need to inject the SDK in each activity, e.g. by creating a base activity which all other activities inherit from:
class BaseActivity : AppCompatActivity()
{
override fun getDelegate(): AppCompatDelegate
{
return DevNagriTranslationSdk.fetchAppDelegate(this, super.getDelegate())
}
}
The SDK override the functionality of @string and getString by default.
In case you don't want to use the system language, you can set a different language in the updateAppLocale method. The language code (locale) needs to be present in a release from Devnagri.
val locale = Locale("hi");
DevNagriTranslationSDK.updateAppLocale(activityContext , locale);
Please note that you will get the english text back if your device language is english or you have not set any specific language for the SDK. To get the translation in Hindi, Please update app locale to Hindi as per above method. Also even after you do not see the text in selected language then please reload your ui controls to get the changes or recreate the activity to force the changes. i.e. You can update the data for recycler view by notifyDataSetChanged method. Also, you should use runOnUiThread for reloading your views in case you see any lag there.
You can get supported languages for the SDK using this method. This will return hashmap of language name and language code
val supportedLangauges = DevNagriTranslationSDK.getAllSupportableLanguages()
You can use these methods anywhere in your project and these will provide translation for current active locale in callback method.
DevNagriTranslationSdk.getTranslationOfString("SampleText"){ translation ->
// use translated text here
}
val arrayList = arrayListOf ("SampleText1","SampleText2","SampleText3")
DevNagriTranslationSdk.getTranslationOfStrings(arrayList){ translations ->
// use translated text here
}
val map = hashMapOf (Pair("A","SampleText1"), Pair("B","SampleText2"), Pair("C","SampleText3") )
DevNagriTranslationSdk.getTranslationOfMap(map){ translations ->
// use translated map here
}
Translations can be used as usual in layouts:
<TextView android:text="@string/translation_key" />
And inside code:
val text = findViewById(R.id.text_id) as TextView
text.setText(R.string.translation_key)