Skip to content

Commit fa0747c

Browse files
authored
Update README.md
1 parent 55be166 commit fa0747c

File tree

1 file changed

+45
-2
lines changed

1 file changed

+45
-2
lines changed

README.md

+45-2
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,46 @@
1-
# XCFramework Now
1+
# XCFrameworkNow
22

3-
Utility for transforming a given library or framework into an XCFramework, generating the arm64 simulator slices if missing.
3+
XCFrameworkNow is a command-line tool that transforms a given library or framework into an XCFramework, generating the arm64 simulator slices if missing.
4+
This allows to build and run Xcode projects natively on Apple Silicon computers even if the developer of the library did not release a compatible version yet. No more Rosetta needed!
5+
6+
It supports static and dynamic libraries as input and can generate the arm64 slices for iOS, tvOS and watchOS simulators.
7+
8+
This tool is based on the project [arm64-to-sim](https://github.com/bogo/arm64-to-sim).
9+
10+
11+
## Installation
12+
13+
### Homebrew
14+
The easiest way to install XCFrameworkNow is by using [Homebrew](https://brew.sh):
15+
```sh
16+
brew tap gui17aume/core
17+
brew install xcframework-now
18+
```
19+
20+
### Manual install
21+
XCFrameworkNow can be compiled and installed manually by retrieving the source code and using the following commands:
22+
```sh
23+
swift build -c release --disable-sandbox
24+
install .build/release/xcframework-now /usr/local/bin
25+
```
26+
27+
## Usage
28+
Convert a framework including the architectures for device and simulator platforms into an XCFramework:
29+
```sh
30+
xcframework-now -framework Foo.framework -output Foo.xcframework
31+
```
32+
33+
Convert a library including the architectures for device and simulator platforms into an XCFramework:
34+
```sh
35+
xcframework-now -library libFoo.a -headers include -output Foo.xcframework
36+
```
37+
38+
Convert a set of frameworks made for various platforms into a single XCFramework:
39+
```sh
40+
xcframework-now -framework Foo-iOS.framework -framework Foo-tvOS.framework -output Foo.xcframework
41+
```
42+
43+
Convert a library split by platform into an XCFramework:
44+
```sh
45+
xcframework-now -library ios/libFoo.a -headers ios/include -library iossimulator/libFoo.a -headers iossimulator/include -output Foo.xcframework
46+
```

0 commit comments

Comments
 (0)