Real-Time Preview

All translations done in the Crowdin Editor can be displayed in your version of the application in real-time. See the translations that have already been done and the ones you're typing.

Setup

Add the following code to the Application class:

Kotlin

override fun onCreate() {
    super.onCreate()

    Crowdin.init(applicationContext,
        CrowdinConfig.Builder()
            .withDistributionHash(your_distribution_hash)
            .withRealTimeUpdates()
            .withSourceLanguage(source_language)
            .withAuthConfig(AuthConfig(
                client_id,
                client_secret,
                request_auth_dialog
            ))
            .withOrganizationName(organization_name)  // required for Crowdin Enterprise
            .withNetworkType(network_type)            // optional
            .withUpdateInterval(interval_in_seconds)  // optional
            .build())
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    Crowdin.init(this,
        new CrowdinConfig.Builder()
            .withDistributionHash(your_distribution_hash)
            .withRealTimeUpdates()
            .withSourceLanguage(source_language)
            .withAuthConfig(new AuthConfig(
                client_id,
                client_secret,
                request_auth_dialog
            ))
            .withOrganizationName(organization_name)   // required for Crowdin Enterprise
            .withNetworkType(network_type)             // optional
            .withUpdateInterval(interval_in_seconds)   // optional
            .build());
}

Authorization

Crowdin Authorization is required for Real-Time Preview feature. Create connection using Activity/Fragment method inMainActivity class:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    Crowdin.authorize(this)
}

Java

@Override
public void onCreate(@Nullable Bundle savedInstanceState, @Nullable PersistableBundle persistentState) {
    super.onCreate(savedInstanceState, persistentState);
    Crowdin.authorize(this);
}

You can disconnect via:

Kotlin

override fun onDestroy() {
    super.onDestroy()
    Crowdin.disconnectRealTimeUpdates()
}

Java

@Override
protected void onDestroy() {
    super.onDestroy();
    Crowdin.disconnectRealTimeUpdates();
}

Tips

• To use the Real-Time Preview feature you still need to wrap context for your activities.
• The OAuth App redirect URL should match your App scheme.
  E.g., for scheme <data android:scheme="crowdintest" /> redirect URL in Crowdin should be crowdintest://.
• To easily control the Real-Time Preview feature you could also use the SDK Controls UI widget.

Config options

Config option	Description	Example
withDistributionHash	Distribution Hash	withDistributionHash("7a0c1...7uo3b")
withRealTimeUpdates	Enable Real-Time Preview feature	withRealTimeUpdates()
withSourceLanguage	Source language code in your Crowdin project	withSourceLanguage("en")
withAuthConfig	Crowdin authorization config	withAuthConfig(AuthConfig("client_id", "client_secret"))
client_id, client_secret	Crowdin OAuth Client ID and Client Secret	"gpY2yC...cx3TYB", "Xz95tfedd0A...TabEDx9T"
request_auth_dialog	Request authorization dialog	true by default or false
withOrganizationName	An Organization domain name (for Crowdin Enterprise users only)	"mycompany" for Crowdin Enterprise or null for crowdin.com
withNetworkType	Network type to be used for translations download	Acceptable values are: - NetworkType.ALL (default) - NetworkType.CELLULAR - NetworkType.WIFI
withUpdateInterval	Translations update interval in seconds. The minimum and the default value is 15 minutes. Translations will be updated every defined time interval once per application load	withUpdateInterval(900)