xworkmate-app/macos/Frameworks/README.md
Haitao Pan a04b22ec4a refactor(storage): unify persistent storage with robust error handling and simplified secret management
- Consolidate settings, tasks, and audit storage into SettingsStore and SecretStore
- Implement PersistentWriteFailure for detailed error reporting across storage scopes
- Migrate secret retrieval to rely primarily on reference-based lookups
- Add ThemeMode persistence and AccountSyncState serialization
- Modernize SecureConfigStore with clear path resolution and support for UI state
- Streamline Rust build process by migrating from custom scripts to Makefile
- Remove redundant build_rust_ffi.sh and update integration scripts
2026-04-19 10:34:15 +08:00

43 lines
1.0 KiB
Markdown

# macOS Frameworks
This directory contains native libraries for macOS integration.
## libcodex_ffi.dylib
The Rust FFI library for Codex CLI integration.
### Building
Run the build script from the project root:
```bash
make rust-build-release
```
### Integration
The library is linked by the Xcode project and loaded at runtime by `CodexFFIBindings`.
### Architecture
- `libcodex_ffi.dylib` - Universal binary (arm64 + x86_64)
- `libcodex_ffi.a` - Static library (for debugging)
### FFI Functions
| Function | Description |
|----------|-------------|
| `codex_init()` | Initialize the library |
| `codex_runtime_create()` | Create a runtime instance |
| `codex_runtime_destroy()` | Destroy a runtime instance |
| `codex_start_thread()` | Start a new thread |
| `codex_send_message()` | Send a message |
| `codex_poll_events()` | Poll for events |
| `codex_shutdown()` | Shutdown the runtime |
| `codex_last_error()` | Get last error message |
### Dependencies
- macOS 11.0 or later
- No external dependencies beyond system libraries