More apps

More apps module helps to make discovering Orange Apps easier than ever.

The ODS More apps module queries the OMA Apps Plus backend to display other Orange applications to discover.

On this page

• Specifications references
• Accessibility
• Integration
  • Jetpack Compose
• Configuration
  • OdsMoreAppsConfiguration API
• Use OdsMoreApps module locally

---

Specifications references

• Design System Manager - More apps

Accessibility

Please follow accessibility criteria for development.

The ODS More apps module is built to support accessibility criteria and is readable by most screen readers, such as TalkBack.

Integration

Prerequisites: Before using the ODS More apps module, you need to create an applications list from the OMA Apps Plus website. Create an account and create your own list from the “App lists” tab. This will create the API key to use in the module configuration.

Jetpack Compose

Follow these steps in order to integrate the ODS More apps module into your app:

1. Add the ODS More apps module to the dependencies section of your build.gradle file:

    dependencies {
        // ...
        implementation 'com.orange.ods.android:ods-module-more-apps:1.0.0'
        // ...
    }
   

2. Add ODS More apps graph to your app navigation graph and provide a lambda that returns a configuration for the module (see Configuration chapter).

    NavHost(
        navController = navController,
        startDestination = StartRoute,
        modifier = Modifier.padding(innerPadding)
    ) {
        //...
        odsMoreAppsGraph {
            OdsMoreAppsConfiguration(
                apiKey = BuildConfig.APPS_PLUS_API_KEY,
                filter = "filter"
            )
        }
        //...
    }
   

3. Use the NavController.navigate() method with OdsMoreAppsDestinations.MoreAppsRoute parameter when you need to display the previously configured ODS MoreApps.

   navController.navigate(OdsMoreAppsDestinations.MoreAppsRoute)
   

Configuration

In order to configure the ODS More Apps Module, you need to provide an OdsMoreAppsConfiguration. The properties of this class are explained below.

OdsMoreAppsConfiguration API

Use OdsMoreApps module locally

As the API key must not be added to Git, you can define it locally in local.properties file at the root of your project. This file must be added to your .gitignore.

Set a build config field by adding the following lines into your build.gradle (inside android{ defaultConfig{ } })

Then, you can use your API key in your code as follow: