GeezerVison

The problem

getShortPluginName drops the npm scope:

sanitizePluginName(pluginName).replace(/[\-]/g, "_")  // "@foo/plugin-x" -> "plugin_x"

That name becomes the temp build directory, the produced .aar and the android namespace fallback. Two plugins from different scopes with the same package name — @foo/plugin-x and @bar/plugin-x — both build a plugin_x.aar, and which one gradle ends up linking depends on build order.

What

A project can give one of them a suffix:

// nativescript.config.ts
export default {
  android: {
    plugins: {
      "@bar/plugin-x": { aarSuffix: "-bar" },
    },
  },
} satisfies NativeScriptConfig;

@bar/plugin-x now builds plugin_x_bar.aar and stops colliding.

android.plugins is a map keyed by npm package name whose entries are spread into the options buildAar receives, so it is also where future per-plugin build settings can go. aarSuffix is the only key it carries today.

Details

The suffix is appended to the plugin name before it is shortened, so it goes through the same sanitizing as the rest of the name.

setupGradle used to recompute getShortPluginName(pluginName) for the namespace fallback (org.nativescript.<short name>), which would have kept colliding. It now takes the already-computed name as a parameter, so the temp directory, the .aar and the namespace all agree.

Nothing changes for a project that does not set plugins — the suffix defaults to empty and the name is exactly what it was.

Not covered

ns plugin build does not read the config: it runs inside a plugin's own directory, where there is no consuming app to declare a suffix. The option is on IPluginBuildOptions, so a hook can still set it there.

Tests

npm test — 1858 passing. The childProcess stub in test/services/android-plugin-build-service.ts now derives the built .aar name from the plugin directory gradle was pointed at instead of assuming it, which let me add two cases: the default name, and the name with aarSuffix applied.

Notes

From https://github.com/Akylas/nativescript-cli. Independent of #6129, #6130 and #6131, though #6129 also touches IAndroidBuildOptions.gradleArgs and the options object in android-project-service — expect a small textual conflict depending on merge order.

Summary by CodeRabbit

• New Features

  • Added optional Android plugin configuration for customizing generated .aar filenames with a suffix.
  • Supports per-plugin suffixes to prevent naming conflicts between similarly named plugins.

• Bug Fixes

  • Improved Android plugin build output naming to consistently honor configured suffixes and plugin paths.