iOS build

Undefined symbols for architecture arm64

Native code is missing when linking

Undefined symbols for architecture arm64. The app references native code that wasn’t compiled in — usually a plugin whose iOS part was never installed.

Updated

What this error means

The app references native code that wasn’t compiled in — usually a plugin whose iOS part was never installed.

Why it happens

The linker has a reference to native code that was never compiled into the app. That happens when a Capacitor plugin’s iOS sources were not installed.

The message tools print

Undefined symbols for architecture arm64:

How to fix it

  1. Run npx cap sync ios so every plugin’s native code is added.
  2. Check that the plugin supports your Capacitor version.
  3. Clean the build folder, then archive again.

Check a log that shows this

Paste the failing step into the build error explainer. It matches this message, and any others in the same log, in your browser. Nothing is uploaded.

Other iOS build errors

Stop signing this on a Mac

CapWrapp creates the Apple Distribution certificate from your App Store Connect API key and installs it, with the provisioning profile, on every GitHub Actions build.

  • Free to start
  • No credit card
  • Sign in with Google or GitHub