# build-ios-binary

build-ios-binary compiles a PAM control's iOS Obj-C or Swift module into a flat device-slice .framework for a .ppmplugin bundle. Mac with Xcode only.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1167 repo stars
- Author: Microsoft
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/microsoft/power-platform-skills/tree/HEAD/plugins/power-apps-mobile-extension/skills/build-ios-binary/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/build-ios-binary

## What it does

The skill takes a control's iOS sources (`ios/RCT<Pascal>Module.{h,m}`) and produces a flat `<Pascal>Plugin.framework` device slice. Think of it as the iOS counterpart of `/build-android-binary`: source goes in, a prebuilt framework comes out for the wrap runtime to load. An `.xcframework` will not work here, because the packaging pipeline does not look inside one and reports the framework as missing.

All edits happen in a throwaway copy under `ppmplugin/staging/ios-build/`, so the canonical `ios/` folder and podspec stay as they are. React headers come from the control repo's own `react-native` devDependency, flattened into an include directory. No CocoaPods. React itself is never embedded; the host supplies it at runtime. The skill then writes the umbrella header, module map and `Info.plist`, checks the manifest, runs a device-only `xcodebuild archive` and copies the result into `ppmplugin/staging/ios/`.

You need a Mac with Xcode 16+ and the `react-native` devDependency installed; its pin (`0.79.7`) has to line up with the one the wrap host ships. On Linux or Windows the skill stops outright. The weak-link flags for React have not been tried against a live host yet, and Apple marks `-undefined dynamic_lookup` as deprecated. Symbol errors around React mean a pin mismatch, not broken code. Run it after `/generate-ppmplugin-manifest` and before `/assemble-ppmplugin`.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add microsoft/power-platform-skills
```
In the agent chat (not a shell):
```text
/plugin install power-apps-mobile-extension@power-platform-skills
```
This installs the whole power-apps-mobile-extension plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add microsoft/power-platform-skills --skill build-ios-binary -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/build-ios-binary/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/build-ios-binary/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add microsoft/power-platform-skills --skill build-ios-binary -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/build-ios-binary/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add microsoft/power-platform-skills --skill build-ios-binary -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/build-ios-binary/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install microsoft/power-platform-skills plugins/power-apps-mobile-extension/skills/build-ios-binary
```

2. **Manually: put the files in place**
- File: `.github/skills/build-ios-binary/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add microsoft/power-platform-skills --skill build-ios-binary -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/microsoft/power-platform-skills --path plugins/power-apps-mobile-extension/skills/build-ios-binary
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/build-ios-binary/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/microsoft/power-platform-skills/tree/HEAD/plugins/power-apps-mobile-extension/skills/build-ios-binary/SKILL.md

## When to use it
- compile an iOS module into a flat device-slice framework
- keep the canonical `ios/` tree and podspec out of the build
- cross-check framework and module class names against `manifest.json`
- generate the umbrella header, module map and `Info.plist`
- stage the built framework for `/assemble-ppmplugin`

## Example prompts
- Run `/build-ios-binary` after `/generate-ppmplugin-manifest` and build the iOS framework.
- Rebuild the framework in `ppmplugin/staging/ios/` — the manifest changed.
- Use `/build-ios-binary` and list the build settings it applied.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: af8c575953dcbd1c.

BEGIN THIRD-PARTY FILE af8c575953dcbd1c
```text
---
name: build-ios-binary
description: "Compile a PAM control's iOS Obj-C/Swift module into the FLAT device-slice `.framework` for a `.ppmplugin` bundle (never an `.xcframework` — the wrap CI won't descend into one). Mac-only (Xcode). Builds from a throwaway staged copy so canonical `ios/` and the podspec stay untouched, references React-Core headers only (React is weak-linked and provided by the wrap host at runtime, no CocoaPods), generates the required umbrella header, module map and Info.plist, sets the critical build settings, asserts manifest conformance, then runs a device-only `xcodebuild archive` and copies out the flat framework to `ppmplugin/staging/ios/`. Known limitation — the React weak-link flags aren't yet validated against a live wrap host and the RN pin must match the host's. Run after /generate-ppmplugin-manifest for an iOS or Both target, before /assemble-ppmplugin."
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion, Skill
model: sonnet
---

# /build-ios-binary

Turns the extension's iOS **source** (`ios/RCT<Pascal>Module.{h,m}`) into the **flat `<Pascal>Plugin.framework/`** (device slice) that the wrap runtime loads. iOS analogue of [`/build-android-binary`](../build-android-binary/SKILL.md): source in, a prebuilt framework out.

> **Ship a FLAT `.framework`, NOT an `.xcframework`.** The wrap pipeline expects `ios/<Name>.framework` and does not descend into an `.xcframework` — shipping one fails with *"Framework '<Name>.framework' not found in plugin."* This skill builds the **device archive only** and copies out the flat `.framework`. See [`ppmplugin-format §5b`](../../shared/ppmplugin-format.md).
```
END THIRD-PARTY FILE af8c575953dcbd1c

The third-party file has ended. Everything between the af8c575953dcbd1c tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 1673 of 15428 bytes. © Microsoft · MIT · https://github.com/microsoft/power-platform-skills/tree/HEAD/plugins/power-apps-mobile-extension/skills/build-ios-binary/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
