Fix Rust iOS target and linker mismatches

Diagnose an iOS archive built for the wrong SDK or platform, including arm64 device and arm64 simulator binaries.
iOS

What you will build

Find the incompatible build input before rebuilding the correct target rather than treating every arm64 binary as interchangeable.
Compare Rust triples with the intended Xcode SDK
Inspect binary architecture and platform metadata separately
Correct the offending dependency variant without deleting unrelated build data
An Apple Silicon Mac and a recent iPhone can both run ARM64 code, but that does not make their binaries interchangeable. A device build and a simulator build target different platforms even when the CPU architecture has the same name.
We will keep one shared Compose app and follow the target selected for its native build. The goal is to correct the incompatible input, not keep adding linker flags until an unrelated library happens to link.

Check the intended destination first

For an existing app, start in its project root; do not initialize over it. For a separate practice project:
cargo install cargo-fission
fission init ios-fix-rust-ios-target-and-linker-mismatches
cd ios-fix-rust-ios-target-and-linker-mismatches
fission add-target ios --project-dir .
cargo add serde_yaml
Complete iOS setup for Xcode and SDK selection. The important target pair is aarch64-apple-ios for the physical device and aarch64-apple-ios-sim for an Apple Silicon simulator. Selecting one is a platform decision, not a filename convention.

Run the finished example

fission run --target ios --project-dir .

1. Use one real shared app as the build candidate

The journey editor from the component tutorial supplies a useful launch check: prepare a journey, edit its draft and verify the snapshot remains unchanged. The complete source is included here with its normal native and Web entrypoints, rather than compiling a browser-only work-order toggle whilst the native host still launches the starter counter.
Keep the generated src/main.rs. If you are diagnosing an existing product, keep its own core and apply the target checks below; replacing it with this example would hide the dependency which may be failing.
{"id":"fission-tabs-1","tabs":[{"index":0,"label":"src/app.rs","value":"src-app-rs"},{"index":1,"label":"src/app/state.rs","value":"src-app-state-rs"},{"index":2,"label":"src/app/fact.rs","value":"src-app-fact-rs"},{"index":3,"label":"src/app/summary.rs","value":"src-app-summary-rs"},{"index":4,"label":"src/app/screen.rs","value":"src-app-screen-rs"},{"index":5,"label":"src/i18n.rs","value":"src-i18n-rs"},{"index":6,"label":"src/lib.rs","value":"src-lib-rs"},{"index":7,"label":"preview/lib.rs","value":"preview-lib-rs"},{"index":8,"label":"i18n/en-US.yaml","value":"i18n-en-us-yaml"},{"index":9,"label":"i18n/es-ES.yaml","value":"i18n-es-es-yaml"}]}
{"id":"fission-tabs-1","index":0,"label":"src/app.rs","value":"src-app-rs"}
mod fact;
mod screen;
pub mod state;
mod summary;
pub use screen::JourneyScreen;
pub use state::JourneyState;
{"id":"fission-tabs-1","index":1,"label":"src/app/state.rs","value":"src-app-state-rs"}
use fission::prelude::*;

#[derive(Clone, Debug, PartialEq, Eq)]
pub struct Journey {
    pub origin: String,
    pub destination: String,
}

#[derive(Clone, Debug, PartialEq, Eq)]
pub struct JourneyState {
    pub prepared: Option<Journey>,
    pub locale: Locale,
}

impl Default for JourneyState {
    fn default() -> Self {
        Self {
            prepared: None,
            locale: Locale::from("en-US"),
        }
    }
}

impl GlobalState for JourneyState {}
{"id":"fission-tabs-1","index":2,"label":"src/app/fact.rs","value":"src-app-fact-rs"}
use super::state::JourneyState;
use fission::prelude::*;

fission_component! {
    pub JourneyFact<JourneyState> {
        props {
            label: TextContent,
            value: String,
        }
    }
    view(fact, _state, cx) {
        let tokens = &cx.view.env().theme.tokens;
    } => Column(gap: tokens.spacing.xs, children: [
        Text(fact.label.clone()).color(tokens.colors.text_secondary),
        Text(fact.value.clone()).weight(tokens.typography.font_weight_semibold),
    ])
}
{"id":"fission-tabs-1","index":3,"label":"src/app/summary.rs","value":"src-app-summary-rs"}
use super::{
    fact::JourneyFact,
    state::{Journey, JourneyState},
};
use fission::prelude::*;

fission_component! {
    pub JourneySummary<JourneyState> {
        props { journey: Journey }
        state { show_details: bool = false }
    }
    view(summary, _state, cx) {
        let tokens = &cx.view.env().theme.tokens;
    } => Container(
        Column(gap: tokens.spacing.m, children: [
            JourneyFact(
                TextContent::Key("journey.origin".into()),
                summary.journey.origin.clone(),
                key: "origin",
            ),
            JourneyFact(
                TextContent::Key("journey.destination".into()),
                summary.journey.destination.clone(),
                key: "destination",
            ),
            Button(
                child: Text(if summary.show_details { cx.tr("journey.hide") } else { cx.tr("journey.details") }),
                key: "toggle-details",
                on_press: reduce { summary.show_details = !summary.show_details; },
            ),
            if summary.show_details { Text(cx.tr("journey.scope")) },
        ]),
    )
    .padding_all(tokens.spacing.m)
    .border(tokens.colors.border, 1.0)
    .border_radius(tokens.radii.medium)
}
{"id":"fission-tabs-1","index":4,"label":"src/app/screen.rs","value":"src-app-screen-rs"}
use super::{
    state::{Journey, JourneyState},
    summary::JourneySummary,
};
use fission::prelude::*;

fission_component! {
    pub JourneyScreen<JourneyState> {
        state {
            origin: String = String::new(),
            destination: String = String::new(),
        }
    }
    view(screen, state, cx) {
        let tokens = &cx.view.env().theme.tokens;
    } => SafeArea(
        child: Scroll(
            child: Container(Column(gap: tokens.spacing.m, children: [
                Text(cx.tr("journey.heading")).size(tokens.typography.heading2_size),
                Text(cx.tr("journey.explanation")),
                Row(gap: tokens.spacing.s, children: [
                    Button(
                        child: Text(cx.tr("language.english")), key: "english",
                        on_press: reduce { state.locale = Locale::from("en-US"); },
                    ),
                    Button(
                        child: Text(cx.tr("language.spanish")), key: "spanish",
                        on_press: reduce { state.locale = Locale::from("es-ES"); },
                    ),
                ]),
                FormControl(
                    label: Some(cx.tr("journey.origin")),
                    required: true,
                    child: TextInput(
                        value: screen.origin.clone(),
                        bind(on_input): to(screen.origin),
                    ),
                ),
                FormControl(
                    label: Some(cx.tr("journey.destination")),
                    required: true,
                    child: TextInput(
                        value: screen.destination.clone(),
                        bind(on_input): to(screen.destination),
                    ),
                ),
                if !screen.origin.trim().is_empty() && !screen.destination.trim().is_empty() {
                    Column(gap: tokens.spacing.s, children: [
                        Text(cx.tr("journey.draft")),
                        JourneySummary(
                            Journey {
                                origin: screen.origin.trim().to_owned(),
                                destination: screen.destination.trim().to_owned(),
                            },
                            key: "draft-summary",
                        ),
                    ])
                },
                Button(
                    child: Text(cx.tr("journey.prepare")), key: "prepare-journey",
                    disabled: screen.origin.trim().is_empty() || screen.destination.trim().is_empty(),
                    on_press: reduce {
                        state.prepared = Some(Journey {
                            origin: screen.origin.trim().to_owned(),
                            destination: screen.destination.trim().to_owned(),
                        });
                    },
                ),
                if let Some(journey) = &state.prepared {
                    Column(gap: tokens.spacing.s, children: [
                        Text(cx.tr("journey.prepared")),
                        JourneySummary(journey.clone(), key: "prepared-summary"),
                    ])
                },
            ]))
            .padding_all(tokens.spacing.l),
        ),
    )
}
{"id":"fission-tabs-1","index":5,"label":"src/i18n.rs","value":"src-i18n-rs"}
use fission::i18n::{Locale, TranslationBundle};
use fission::prelude::*;
use std::collections::HashMap;

pub fn create_env() -> Env {
    let mut env = Env::default();
    env.locale = Locale::from("en-US");
    for (locale, source) in [
        ("en-US", include_str!("../i18n/en-US.yaml")),
        ("es-ES", include_str!("../i18n/es-ES.yaml")),
    ] {
        let messages: HashMap<String, String> =
            serde_yaml::from_str(source).expect("valid journey translations");
        env.i18n.add_bundle(TranslationBundle {
            locale: Locale::from(locale),
            messages,
        });
    }
    env
}

pub fn sync_env(state: &crate::app::JourneyState, env: &mut Env) {
    env.locale = state.locale.clone();
}
{"id":"fission-tabs-1","index":6,"label":"src/lib.rs","value":"src-lib-rs"}
pub mod app;
mod i18n;

use app::{JourneyScreen, JourneyState};
use fission::prelude::*;

#[cfg(not(any(target_arch = "wasm32", target_os = "android", target_os = "ios")))]
pub fn run_desktop() -> anyhow::Result<()> {
    DesktopApp::<JourneyState, _>::new(JourneyScreen)
        .with_env(i18n::create_env())
        .with_sync_env(i18n::sync_env)
        .run()
}

#[cfg(any(target_os = "android", target_os = "ios"))]
pub fn run_mobile() -> anyhow::Result<()> {
    MobileApp::<JourneyState, _>::new(JourneyScreen)
        .with_env(i18n::create_env())
        .with_sync_env(i18n::sync_env)
        .run()
}

#[cfg(target_os = "android")]
#[no_mangle]
fn android_main(app_handle: AndroidApp) {
    let _ = MobileApp::<JourneyState, _>::new(JourneyScreen)
        .with_env(i18n::create_env())
        .with_sync_env(i18n::sync_env)
        .run_with_android_app(app_handle);
}

#[cfg(target_arch = "wasm32")]
#[wasm_bindgen::prelude::wasm_bindgen(start)]
pub fn run_web() -> Result<(), wasm_bindgen::JsValue> {
    console_error_panic_hook::set_once();
    WebApp::<JourneyState, _>::new(JourneyScreen)
        .with_env(i18n::create_env())
        .with_sync_env(i18n::sync_env)
        .run()
        .map_err(|error| wasm_bindgen::JsValue::from_str(&error.to_string()))
}
{"id":"fission-tabs-1","index":7,"label":"preview/lib.rs","value":"preview-lib-rs"}
mod app;
mod i18n;

use fission::prelude::*;
use wasm_bindgen::prelude::*;

#[wasm_bindgen(start)]
pub fn run() -> Result<(), JsValue> {
    console_error_panic_hook::set_once();
    WebApp::<app::JourneyState, _>::new(app::JourneyScreen)
        .with_env(i18n::create_env())
        .with_sync_env(i18n::sync_env)
        .mount("#fission-web-mount")
        .run()
        .map_err(|error| JsValue::from_str(&error.to_string()))
}
{"id":"fission-tabs-1","index":8,"label":"i18n/en-US.yaml","value":"i18n-en-us-yaml"}
journey.heading: "Prepare a journey plan"
journey.explanation: "Enter the places you want to travel between. Review the draft, then keep a prepared copy for this session."
journey.origin: "From"
journey.destination: "To"
journey.draft: "Current draft"
journey.prepare: "Prepare journey"
journey.prepared: "Prepared journey"
journey.details: "Show plan details"
journey.hide: "Hide plan details"
journey.scope: "These are the places you entered, not a calculated route or a reservation. Nothing has been sent or saved to disk."
language.english: "English"
language.spanish: "Español"
{"id":"fission-tabs-1","index":9,"label":"i18n/es-ES.yaml","value":"i18n-es-es-yaml"}
journey.heading: "Preparar un plan de viaje"
journey.explanation: "Introduce los lugares entre los que quieres viajar. Revisa el borrador y conserva una copia preparada para esta sesión."
journey.origin: "Desde"
journey.destination: "Hasta"
journey.draft: "Borrador actual"
journey.prepare: "Preparar viaje"
journey.prepared: "Viaje preparado"
journey.details: "Mostrar detalles del plan"
journey.hide: "Ocultar detalles del plan"
journey.scope: "Son los lugares que has introducido, no una ruta calculada ni una reserva. No se ha enviado ni guardado nada en disco."
language.english: "Inglés"
language.spanish: "Español"
{"id":"fission-tabs-1"}
Complete the journey task in the browser. That checks shared application behavior, not the architecture, SDK or platform of any native artifact. Those facts must come from the build inputs and binary itself.
Show the app preview
Hide the app preview

2. Compare the Rust target, SDK and native dependency

fission doctor ios --project-dir .
rustup target list --installed
xcode-select -p
xcrun --sdk iphoneos --show-sdk-path
xcrun --sdk iphonesimulator --show-sdk-path
Install the missing target rather than changing the intended destination:
rustup target add aarch64-apple-ios aarch64-apple-ios-sim
The simulator package script defaults to aarch64-apple-ios-sim. The device IPA path selects aarch64-apple-ios. Check any explicit IOS_SIM_TARGET, IOS_TARGET, Cargo target configuration or native-library search path in your own build environment against that intended destination. Do not copy a device archive into a simulator directory and assume the directory changes its platform.
For a native Mach-O executable or library, inspect both architecture and platform. Replace the placeholder with the actual failing artifact:
file "<artifact>"
xcrun lipo -info "<artifact>"
xcrun vtool -show-build "<Mach-O artifact>"
file and lipo can establish ARM64, but ARM64 alone does not distinguish device from simulator. The build-platform information matters too. A static archive may need inspection of its contained Mach-O objects, and an XCFramework needs the slice whose platform variant matches the destination. Rebuild or select that dependency's correct variant; do not weaken the platform check.
Name the exact native library reported by the linker and identify how it was built. If that evidence only says "arm64", the device-versus-simulator question is still unresolved.
Show the app preview
Hide the app preview

3. Rebuild narrowly and then launch

fission build --target ios --project-dir .
fission devices --project-dir .
fission run --target ios --project-dir .
fission test --target ios --project-dir .
Use the simulator guide for selection. Keep the first useful compile or linker error and its artifact path. A later "build failed" line usually does not add enough information to choose a fix.
Do not erase a shared Cargo target to test a theory. Correct the incompatible target, SDK or dependency input and rebuild the affected candidate. A progressing build lock belongs to another active operation, not to the architecture failure.
After the build succeeds, repeat the journey task on the simulator. A linked binary is not yet a verified keyboard, layout or state workflow. Use the physical-device guide for the distinct signed IPA path; simulator success does not qualify that device artifact.