# Undefined symbols for architecture arm64

> Getting the error “Undefined symbols for architecture arm64”? Here is how to fix it. A Capacitor plugin’s iOS code was never installed into the app.

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

- iOS build. Native code is missing when linking.
- Interactive page: https://capwr.app/free-tools/build-error-explainer/undefined-symbols-for-architecture
- Build error explainer: https://capwr.app/free-tools/build-error-explainer
- Last updated: 2026-10-03

## 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](https://capwr.app/free-tools/build-error-explainer). It matches this message, and any others in the same log, in your browser. Nothing is uploaded.

## Other iOS build errors

- [No signing certificate "iOS Distribution" found](https://capwr.app/free-tools/build-error-explainer/no-signing-certificate)
- [No profiles for your bundle ID were found](https://capwr.app/free-tools/build-error-explainer/no-provisioning-profile)
- [Xcode: signing requires a development team](https://capwr.app/free-tools/build-error-explainer/requires-a-development-team)
- [Provisioning profile doesn't support the capability](https://capwr.app/free-tools/build-error-explainer/provisioning-profile-missing-capability)
- [Podfile.lock is not in sync with the sandbox](https://capwr.app/free-tools/build-error-explainer/podfile-lock-out-of-sync)
- [CocoaPods could not find compatible versions](https://capwr.app/free-tools/build-error-explainer/cocoapods-could-not-find-compatible-versions)
- [PhaseScriptExecution failed with a nonzero exit code](https://capwr.app/free-tools/build-error-explainer/phasescriptexecution-failed)

## 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.

[Get started free](https://capwr.app/login).

## About CapWrapp

CapWrapp turns a web app on GitHub — built with Lovable, Bolt, Base44, Cursor or by hand — into iPhone and Android apps. It adds Capacitor if the repo needs it, signs the builds, and ships them to TestFlight and Google Play from GitHub Actions, with no Mac or Xcode on your side. [Get started free](https://capwr.app/login) · [Lovable to App Store guide](https://capwr.app/guides/lovable-to-app-store)