OrangeBusinessToolsTheme

The Orange Business Tools theme.

This theme uses the Helvetica Neue font family. Due to legal issues Helvetica Neue font files are not bundled with this library.

The Helvetica Neue font files for the Orange Business Tools theme are available at https://brand.orange.com/en/brand-basics/typography and can be used by copying the ttf files in the res/font directory of the project and by using an implementation of OrangeBundledFontFamily (OrangeHelveticaNeueLatin.Bundled or OrangeHelveticaNeueArabic.Bundled) when creating the OrangeFontFamily instance passed as the OrangeBusinessToolsTheme.orangeFontFamily parameter:

OrangeBusinessToolsTheme(
    orangeFontFamily = OrangeFontFamily(
        latin = OrangeHelveticaNeueLatin.Bundled(
            R.font.helvetica_neue_latin_regular,
            R.font.helvetica_neue_latin_medium,
            R.font.helvetica_neue_latin_bold
        ),
        arabic = OrangeHelveticaNeueArabic.Bundled(
            R.font.helvetica_neue_arabic_light,
            R.font.helvetica_neue_arabic_regular,
            R.font.helvetica_neue_arabic_medium,
        )
    )
)

Although the preferred way of using the Helvetica Neue font is configuring bundled font files, there are some cases where this is not possible, for instance in open source projects where the font files cannot be bundled due to legal issues. In these cases, the font files can alternatively be downloaded through the Android Downloadable Fonts feature by using an implementation of OrangeDownloadableFontFamily (OrangeHelveticaNeueLatin.Downloadable or OrangeHelveticaNeueArabic.Downloadable) instead:

OrangeBusinessToolsTheme(
    orangeFontFamily = OrangeFontFamily(
        latin = OrangeHelveticaNeueLatin.Downloadable,
        arabic = OrangeHelveticaNeueArabic.Downloadable
    )
)

In order to enable the Android Downloadable Fonts feature for the Orange Business Tools theme, please also add OrangeFontProvider as a provider in your app manifest:

<provider
    android:name="com.orange.ouds.theme.orange.OrangeFontProvider"
    android:authorities="com.orange.ouds.theme.orange.fontprovider"
    android:exported="false" />

As well as the following permission:

<uses-permission android:name="android.permission.INTERNET" />

Finally, call the OrangeFontFamily.preloadDownloadableFontFamilies method in the onCreate method of your application singleton or main activity, and use the onComplete parameter to update your UI when preload is complete:

var areDownloadableOrangeFontFamiliesPreloaded by mutableStateOf(false)
    private set

OrangeFontFamily.preloadDownloadableFontFamilies(this, listOf(OrangeHelveticaNeueLatin.Downloadable, OrangeHelveticaNeueArabic.Downloadable)) {
    areDownloadableOrangeFontFamiliesPreloaded = true
}

Please note that the Android Downloadable Font feature works asynchronously, whether the font is already downloaded or not, and that FontFamily.Default will be used if download fails.

Parameters