Skip to content

Android Library to provide locale support to Chronos πŸ“± βœ…

License

Notifications You must be signed in to change notification settings

headout/chronos-localiser

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Chronos Localiser 🌐 πŸ“

Android doesn't provide the direct support to change the language of the activities that are already created. Whenever we change the locale the new locale is applied to new activities only. In short the user have to restart all activities / app to have use the new language.

Solution πŸš€

This library provide the solution to this problem, the update locale is applied to all the activities that will be created and also to those that are present in the back stack. Apart from this there are some other features which are provided by this library

Features ✨

  • Support to retain the locale of the app after the app is shutdown.
  • Easy to use and very Small footprint (~5KB, ~40 methods)

Prerequisite πŸ”’

Step 1. Add the JitPack repository to your build file

Add it in your root build.gradle at the end of repositories:

allprojects {
	repositories {
		...
		maven { url 'https://jitpack.io' }
	}
}

Step 2. Add the dependency

dependencies {
        implementation 'com.github.govinddixit:chronos-localiser:1.0.0'
}

How to use πŸ’¬

Extend your app class

class Application : LocaleAwareApplication() {
  ....
}

Extend your base activity class

open class BaseActivity : LocaleAwareCompatActivity() {  
  ....
}

LocaleAwareCompatActivity provides a helper method called updateLocale which is used to update the locale. That's all folks, You are now ready to use it in full power ⚑

Demo

Language resources optimization in Android App Bundle πŸ’‘

Change the language by library can cause a crash to your app when you publishing your app with Android App Bundle with language resources optimization enabled.

To fix this, Using the Additional Languages API in Play Core library to download the additional language before.

For more information about Additional Language API. Check here

If you don't want to implement this feature in your code, just ignore the language resources optimization by adding the Android App Bundle configuration in your app's build.gradle

android {
    ... 
    bundle { 
        language { 
            enableSplit = false 
        } 
    } 
}

Credits πŸ‘₯

Govind Dixit

License πŸ“„

Project is published under the Apache 2.0 license. Feel free to clone and modify repo as you want, but don't forget to add reference to authors :)

About

Android Library to provide locale support to Chronos πŸ“± βœ…

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages