Skip to content

Latest commit

 

History

History
128 lines (94 loc) · 4.09 KB

README.md

File metadata and controls

128 lines (94 loc) · 4.09 KB
Raw

dweb_browser_libs

dweb_browser static library reference.

如何创建一个新的绑定

  1. 复制keychainstore项目重命名为自己需要创建的绑定。
  2. 删除里面的build、src 文件夹。
  3. 按需修改 build-mobile.gradle.kts 和 build.gradle.kts 修改成跟自己项目相关的。
  4. .def 文件内容是到ios 静态链接库的绑定，如果不是给 ios创建绑定可以不管。
  5. 按照自己的要求修改uniffi 文件夹里的 rust 代码去实现特定的功能。
  6. uniffi文件夹内部的.sh、toml文件内容同步成自己的项目名。
  7. uniffi/src 下的.udl文件则是暴露给 kotlin 的调用入口，修改成自己实现的API就可以。
  8. 如果在windows 平台的代码写完了，可以在windows-lib/examples先进行测试，每个平台的绑定测试通过了再进行编译。
  9. 运行build.sh可以自动化生成 rust 绑定的 kotlin 代码。
  10. 所有的测试通过并且编译完成之后可以运行Gradle Sync,同步完就可以在对应目标引入绑定的项目了implementation(projects.libKeychainstore)

关于更细节的 windows/apple rust 代码的绑定如何实现，可以参考文件夹内其他项目。

如果有时候编译不出来，可以修改一下build.rs里的内容，让其产生变更在进行编译。

Add Rust Target

# android
rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-android x86_64-linux-android

# ios
rustup target add aarch64-apple-ios x86_64-apple-ios aarch64-apple-ios-sim

# macos
rustup target add aarch64-apple-darwin x86_64-apple-darwin

# windows on windows
rustup target add x86_64-pc-windows-msvc aarch64-pc-windows-msvc
# [install winget](https://learn.microsoft.com/en-us/windows/package-manager/winget/)
winget install Microsoft.VisualStudio.BuildTools

# windows on macos/linux
rustup target add x86_64-pc-windows-gnu

Install toolchains on MacOS

  1. 下载并解压 https://github.com/mstorsjo/llvm-mingw/releases/download/20240619/llvm-mingw-20240619-ucrt-macos-universal.tar.xz

  2. 到 ~/.cargo/config.toml 中修改

    [target.x86_64-pc-windows-gnu]
linker = "x86_64-w64-mingw32-gcc"

[target.aarch64-pc-windows-gnullvm]
linker = "PATH_TO_LLVM_MINGW_UCRT_MACOS_UNIVERSAL/bin/aarch64-w64-mingw32-clang"

build dynamic link library

只需要运行每个uniffi下的build-*.sh 文件即可编译成各个平台的动态链接库。

Build Android

cargo install cbindgen
cargo install cargo-ndk
cargo ndk -t aarch64-linux-android -o ../src/androidMain/jniLibs build --release
cargo ndk -t armv7-linux-androideabi -o ../src/androidMain/jniLibs build --release
cargo ndk -t i686-linux-android -o ../src/androidMain/jniLibs build --release
cargo ndk -t x86_64-linux-android -o ../src/androidMain/jniLibs build --release

Build iOS

cargo build --release --target aarch64-apple-ios
cargo build --release --target x86_64-apple-ios
cargo build --release --target aarch64-apple-ios-sim

Build MacOS

cargo build --release --target aarch64-apple-darwin
cargo build --release --target x86_64-apple-darwin

Build Window

cargo build --release --target x86_64-pc-windows-msvc
cargo build --release --target aarch64-pc-windows-msvc

Build Linux

Build for you self XD.

publish maven

发布到本地

  1. 生成gpg文件
  2. 取出 private key
gpg --keyring secring.gpg --export-secret-keys > ~/.gnupg/secring.gpg
  1. 需要在local.properties文件中配置:
# gpg生成的keyId为后8位
signing.keyId=
# gpg文件路径secring.gpg路径
signing.secretKeyRingFile=
# gpg设置的密码
signing.password=

# ossrh http://s01.oss.sonatype.org/ 中的token的username和password
ossrhUsername=
ossrhPassword=
  1. 到 rust_library 目录下运行：
./gradlew publishToMavenLocal

发布后会在本地的~/.m2 生成包。项目使用在setting.gradle.kts 设置 mavenLocal()就能快速调试。