localized-app-name-plugin
Mobile icon

Localized App Name Plugin

Stable version 1.1.1 (Compatible with OutSystems 11)
Uploaded
 on 24 Jun (22 hours ago)
 by 
5.0
 (1 rating)
localized-app-name-plugin

Localized App Name Plugin

Details
Localizes your app's home-screen display name on iOS and Android based on the device language.
Read more

Show your mobile app's home-screen name in the user's language — automatically.


Most apps ship with a single hard-coded name, meaning every user sees the same label regardless of their device language. Portuguese users still see “Weather”, Spanish users see “Weather”, everyone sees the same thing. This plugin solves that.


Set the device language to Portuguese and the app icon displays “Tempo”. Switch to English and it becomes “Weather”. In Spanish, it shows “Clima”. For any language you don’t explicitly configure, the plugin automatically falls back to your default app name — so you only need to define the locales you actually support.


How it works


Upload one tiny JSON per language as a Module Resource. The plugin runs at MABS build time and generates the native iOS and Android localization resources — no native code edits, one plugin for both platforms.

Example pt.json:

{

  "config_ios": {

    "CFBundleDisplayName": "Tempo"

  },

  "config_android": {

    "app_name": "Tempo"

  }

}

Why this plugin


Built and tested specifically for OutSystems 11, with explicit fixes for the platform's quirks (Module Resources flattened to www/, cordova-ios pbxproj cache invalidating hook edits during signing, older cordova-ios templates).

Focused exclusively on the home-screen app name — no Localizable.strings, no Settings.bundle. One job, done right.


Setup in OutSystems

  • Add this plugin module via Manage Dependencies in your mobile app.
  • Set in your Extensibility Configurations (required on iOS)
{
  "preferences": {
     "ios": [
          { "name": "CFBundleAllowMixedLocalizations", "value": "true" }    
     ]
  }
}
  • Upload en.json, pt.json, es.json, etc. as Module Resources (Deploy to Target Directory).
  • 1-Click Publish and trigger a MABS build.
Release notes (1.1.1)

New Feature:

Set a default home-screen app name for devices whose language isn't covered by your locale JSON files. Add it to your mobile app's Extensibility Configurations under preferences.global:

{
  "preferences": {
    "global": [
      { "name": "AppDefaultName", "value": "Weather" }
    ]
  }
}

One value applies to both iOS and Android. If not set, the OS falls back to the app name defined in the module.

License (1.1.1)
Reviews (0)
Team
Other assets in this category