You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This includes:
* Correctly calling `uniffi-bindgen` through cargo.
* Ditching lipo for individual static libraries per target, that way it
easily works on all Mac hardware (x86_64 or arm64) as well as for iOS
hardware targets.
* Build a `staticlib` using cargo's new `--crate-type` option
Copy file name to clipboardExpand all lines: examples/app/ios/IOSApp.xcodeproj/project.pbxproj
+9-5Lines changed: 9 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -34,7 +34,7 @@
34
34
"$(SRCROOT)/Generated/$(INPUT_FILE_BASE)FFI.h",
35
35
"$(SRCROOT)/Generated/$(INPUT_FILE_BASE).swift",
36
36
);
37
-
script = "# Generate swift bindings for the todolist rust library.\necho \"Generating files for $INPUT_FILE_PATH\"\n\"$SRCROOT/../../../target/debug/uniffi-bindgen\" generate \"$INPUT_FILE_PATH\" --language swift --out-dir \"$SRCROOT/Generated\"\necho \"Generated files for $INPUT_FILE_BASE in $SRCROOT/Generated\"\n";
37
+
script = "# Generate swift bindings for the todolist rust library.\necho \"Generating files for $INPUT_FILE_PATH\"\n$HOME/.cargo/bin/cargo run -p uniffi_bindgen -- \\\n generate \"$INPUT_FILE_PATH\" \\\n --language swift \\\n --out-dir \"$SRCROOT/Generated\"\necho \"Generated files for $INPUT_FILE_BASE in $SRCROOT/Generated\"\n";
The header file is a descriptor of the C API to a library that hasn't been built yet. The Swift file is a Swift facade that calls that C API.
@@ -49,91 +55,89 @@ The header file is a descriptor of the C API to a library that hasn't been built
49
55
#ifndef IOSApp_Bridging_Header_h
50
56
#define IOSApp_Bridging_Header_h
51
57
52
-
#import "todolist-Bridging-Header.h"
58
+
#import "todolistFFI.h"
53
59
54
60
#endif/* IOSApp_Bridging_Header_h */
55
61
```
56
62
57
-
The `#import` directive points to the header file generated by `uniffi-bindgen generate` above— `$(DERIVED_FILE_DIR)/$(INPUT_FILE_BASE)-Bridging-Header.h`
63
+
The `#import` directive points to the header file generated by `uniffi-bindgen generate` above— `$(DERIVED_FILE_DIR)/$(INPUT_FILE_BASE)FFI.h`
58
64
59
65
```h
60
-
#import"todolist-Bridging-Header.h"
66
+
#import"todolistFFI.h"
61
67
```
62
68
63
69
This `IOSApp-Bridging-Header.h` tells Xcode to look for the header file; because it's in `DERIVED_FILE_DIR`, Xcode should know where to look.
64
70
65
71
## Configure `cargo` to build the crate as a static library
66
72
67
-
1.In the `Cargo.toml` file of the Rust project, add `staticlib` to the `crate-type` list.
73
+
1.The build script automatically builds a static library (note: this requires rustc 1.64 or newer)
68
74
69
75
```toml
70
76
[lib]
71
-
crate-type = ["staticlib", "cdylib"]
72
77
name = "uniffi_todolist"
73
78
```
74
79
75
80
The `package``name` and the `lib``name` will be used below. In this case, the package name is `uniffi-example-todolist` and the lib name is `uniffi_todolist`.
76
81
77
82
## Tell Xcode how to build the Rust project.
78
83
79
-
#### TODO use a better explanation of what is going on here
80
-
81
84
1. In Xcode, click on the project in the Project Navigator.
82
85
2. In the main window, select the app's main target, and then select "Build Phases".
83
86
3. Add a new `Run Script` build phase and move it to the top.
84
87
4. Add the script that will build a universal binary for the Rust project.
85
88
86
-
For this project, we've used a script adapted from the #mozilla/application-services project to build a universal binary with `lipo`.
89
+
`uniffi` comes with a script suitable to build a static library for all iOS targets:
*`STATIC_LIB_NAME` from the `lib``name` above: `uniffi_todolist` -->`libuniffi_todolist.a`
101
103
*`FFI_TARGET` from the `package``name` above: `uniffi-example-todolist`.
102
104
103
105
The workspace path is where the `Cargo.toml` will resolve the Rust project, and also determine the target directory that `cargo build` and `lipo` will put its artifacts.
104
106
105
-
This script performs a few steps:
106
-
107
-
1. Runs `cargo build` to compile the Rust project for the `x86_64-apple-ios` and `aarch64-apple-ios` targets.
108
-
* This includes using `uniffi-bindgen` to generate the Rust scaffolding so we can go from C to Rust.
109
-
2. Runs `lipo` to combine these libs in to a universal binary.
110
-
3. Puts the universal binary in to the `$WORKSPACE_PATH/target/universal` directory.
107
+
This script runs `cargo build` to compile the Rust project for the `x86_64-apple-ios`, `aarch64-apple-ios` and `aarch64-apple-ios-sim` targets.
108
+
This includes using `uniffi-bindgen` to generate the Rust scaffolding so we can go from C to Rust.
111
109
112
110
## Tell Xcode where the universal library is
113
111
114
-
Finally, we need to tell Xcode to look for the universal binary `libuniffi_todolist.a` is, so it can tie it together with the header file `todolist-Bridging-Header.h`.
112
+
Finally, we need to tell Xcode to look for the libraries based on the target, so it can tie it together with the header file `todolistFFI.h`.
115
113
116
114
1. In Xcode, click on the project in the Project Navigator.
117
115
2. In the main window, selectthe app's main target, and then select "Build Settings".
118
116
3. Search for `Library Search Paths`.
119
-
4. Add paths to where lipo constructed the universal binaries for each of `Debug` and `Release`.
117
+
4. Add paths per OS and architecture.
118
+
The OS specific part can be configured in the Xcode project editor,
119
+
but the architecture specific part has to be added by manually editing the `project.pbxproj` file.
120
+
Open `project.pbxproj` in your project direcotry and add the following in the `Debug` section:
0 commit comments