Ionic 5 + Angular + Cordova项目构建预生产环境APK后Cordova缺失致原生插件失效问题求助

Let’s break down what’s going wrong here and fix your build process step by step. The core issue is that your manual three-step build isn’t properly integrating Cordova into your preprod environment, which is why the cordova platform flag is missing and native plugins fail to initialize.

Why Your Current Flow Fails #

When you run ionic cordova run android, Ionic handles full integration between your Angular app and Cordova automatically: it injects the cordova.js script into your index.html, adds platform-specific configuration, and ensures Cordova’s initialization logic is baked into the build.

Your current workflow skips this critical integration:

1. ionic build --prod --platform=android --configuration=preprod is a pure web build — it doesn’t include any Cordova-specific code or injections.
2. ionic cordova prepare android --no-build --prod only copies your pre-built web files into the Android project, but doesn’t add the missing Cordova initialization (like cordova.js).
3. Without cordova.js loading, Cordova never initializes, so the Platform service can’t detect it, and plugins throw the "Cordova is not available" error.

Fix 1: Update Your Angular.json Configuration #

The error you got when running ionic cordova build android --configuration=preprod happens because you only added the preprod config to the build architect, but not to the ionic-cordova-build architect. Ionic needs this mapping to know which build config to use for Cordova builds.

Open your angular.json and add the preprod configuration under architect -> ionic-cordova-build:

{
  "projects": {
    "app": {
      "architect": {
        "build": {
          "configurations": {
            "preprod": { /* Your existing preprod config */ }
          }
        },
        "ionic-cordova-build": {
          "configurations": {
            "preprod": {
              "browserTarget": "app:build:preprod"
            }
          }
        }
      }
    }
  }
}

Fix 2: Use a Single Integrated Build Command #

Now you can use Ionic’s native Cordova build command, which handles all integration steps automatically. Replace your three build steps with this single command:

ionic cordova build android --prod --release --configuration=preprod

This command will:

1. Build your Angular app using the preprod configuration
2. Inject Cordova’s cordova.js and platform-specific logic into the build
3. Prepare the Android project with the correct web assets
4. Generate a release-ready unsigned APK

Finish with Signing and Zipalign #

Once the unsigned APK is generated, run your existing signing and zipalign commands as before:

jarsigner -verbose -sigalg SHA1withRSA -digestalg SHA1 -keystore <PATH_TO_KS> <PATH_TO_APK> <KEY_NAME>
zipalign -v 4 <PATH_TO_APK> <PATH_TO_SIGNED_APK>

Validation Steps #

To confirm the fix works:

1. After building, check the index.html file in platforms/android/app/src/main/assets/www/ — you should see <script src="cordova.js"></script> included.
2. Install the signed APK on your emulator/device and verify the Platform service returns android,phablet,cordova,desktop,hybrid (including the cordova flag).
3. Test the QR Scanner and In-app Browser plugins to ensure they function as expected.

Quick Check: Ensure Cordova Whitelist Plugin is Installed #

While this is usually included by default, double-check that the whitelist plugin is installed (it’s required for Cordova to work properly):

ionic cordova plugin list

If cordova-plugin-whitelist isn’t listed, install it:

ionic cordova plugin add cordova-plugin-whitelist

内容的提问来源于stack exchange，提问作者Nikos Paraskevopoulos