Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/RGB-Tools/rgb-lib-swift
https://github.com/RGB-Tools/rgb-lib-swift
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/RGB-Tools/rgb-lib-swift
- Owner: RGB-Tools
- License: mit
- Created: 2022-09-13T09:48:32.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-08-29T15:16:03.000Z (4 months ago)
- Last Synced: 2024-08-29T16:58:34.443Z (4 months ago)
- Language: Swift
- Size: 71.3 KB
- Stars: 3
- Watchers: 1
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-rgb-protocol - RGB Lib Swift bindings
README
# RGB Lib Swift bindings
This project builds a Swift library, `RgbLib`, for the [rgb-lib]
Rust library, which is included as a git submodule. The bindings are created by
the [rgb-lib-uniffi] project, which is located inside the rgb-lib submodule.## Usage
To use the Swift language bindings in your Xcode iOS or MacOS project add
its GitHub repository (https://github.com/RGB-Tools/rgb-lib-swift) and select
one of the release versions.
Then link the C++ library by going to
`Build Phases -> Link Binary With Libraries -> Add items (+)` and adding
`libc++.tbd`.
You may then import and use the `RgbLib` library in your Swift code.## Build and publish
If you are a maintainer of this project or want to build and publish this
project to your own Github repository use the following steps:```shell
# Update the submodule
git submodule update --init# Generate the bindings and FFI ZIP
./generate.sh
```Then update the `Package.swift` file with the new expected URL for the ZIP
file and new checksum as shown at the end of the `generate.sh` script.
For example:
```swift
.binaryTarget(
name: "rgb_libFFI",
url: "https://github.com/RGB-Tools/rgb-lib-swift/releases/download/0.3.0-alpha.9/rgb_libFFI.xcframework.zip",
checksum: "0482d85d8a4865fc785029d9d5afd4e5c5322d118f36cf1a48aabe65f8d226b1"),
```Commit the changed `Package.swift` file, then tag the commit with the new
version number.Finally, create a GitHub release for your new tag and upload the newly created
ZIP to the new GitHub release and publish the release.Now you can test the new package in Xcode.
If you get an error you might need to reset the Xcode package caches:
`File -> Packages -> Reset Package Caches`.[rgb-lib]: https://github.com/RGB-Tools/rgb-lib
[rgb-lib-uniffi]: https://github.com/RGB-Tools/rgb-lib/tree/master/bindings/uniffi