NativeScript Dotenv Plugin

Adds common NativeScript configurations to Dotenv

Contents

• Installation
• Usage
• Configuration
• Android versionCode
• Verbose logging

Installation

npm i -D @ontrackms/nativescript-dotenv

Usage

Add these lines to the exported function in webpack.config.js:

const { NativeScriptDotEnvPlugin } = require("@ontrackms/nativescript-dotenv");

module.exports = (env) => {
  webpack.init(env);
  // must be called after webpack.init
  NativeScriptDotEnvPlugin.init(webpack);
  return webpack.resolveConfig();
};

Configuration

All of the following .env variables are optional ⚙️ — set only the ones you need.

| Variable | Controls | | --- | --- | | NATIVESCRIPT_BUNDLE_ID | The app's bundle identifier, written to package.json's name field. | | NATIVESCRIPT_BUNDLE_VERSION | A semver string (e.g. 3.2.1, or 3.2.1+42 for an explicit build number). Written to package.json's version, iOS's CFBundleShortVersionString/CFBundleVersion, and Android's versionName (see Android versionCode below for versionCode). | | NATIVESCRIPT_APPLE_TEAM_ID | The iOS code-signing team, written to DEVELOPMENT_TEAM in build.xcconfig. |

NATIVESCRIPT_BUNDLE_ID=com.corp.app.test
NATIVESCRIPT_BUNDLE_VERSION=3.2.1
NATIVESCRIPT_APPLE_TEAM_ID=ASDFG1234

Android versionCode

Android's versionCode (in App_Resources/Android/src/main/AndroidManifest.xml) is auto-incremented on release builds only — ns build android --release or ns run android --release — which set webpack's env.production flag.

Regular dev builds (ns run android without --release) leave AndroidManifest.xml untouched, so versionCode doesn't creep up on every rebuild.

Verbose logging

By default, the plugin prints the parsed .env values to the console — handy while developing locally.

Since a .env file may hold secrets unrelated to this plugin, that logging is automatically disabled on CI/cloud builds, detected via the CI environment variable set by virtually every provider (GitHub Actions, GitLab CI, Bitrise, App Center, Codemagic, Travis, etc.).

Override this explicitly with the verbose option:

NativeScriptDotEnvPlugin.init(webpack, { verbose: false });