- 源码 316 文件收编为 rusto-rs/ 文件夹,随本仓库管理 - 移除内部 .git(补丁已存档 docs/rusto-rs-metal-patch-20260912.patch,上游可随时 re-clone) - target/ 与 docs/.yarn 缓存不入库;本地改动:ROCR_* 环境变量调优 + Metal 链接修复 + 预处理测试脚本
5.0 KiB
title, description, navigation, seo
| title | description | navigation | seo | ||||||
|---|---|---|---|---|---|---|---|---|---|
| Instalasi | Cara memasang RustO! di Rust, .NET, React Native, iOS, Android, dan Native C FFI. |
|
|
RustO! dikemas secara modular di berbagai ekosistem manajer paket bahasa. Pilih target lingkungan pengembangan Anda di bawah ini.
1. Rust (Cargo.toml)
Tambahkan rusto-rs via cargo:
cargo add rusto-rs
Atau definisikan langsung pada file Cargo.toml:
[dependencies]
rusto-rs = "0.2.4"
Fitur Opsional Cargo
| Fitur | Deskripsi |
|---|---|
ffi |
Mengaktifkan C FFI dan JNI bindings untuk mengintegrasikan RustO! ke runtime bahasa lain. |
use-opencv |
Mengaktifkan backend OpenCV opsional untuk pengujian komparasi dan verifikasi paritas visual. |
build-from-source |
Mengompilasi mesin inferensi MNN C++ langsung dari kode sumber alih-alih biner pra-rakit. |
metal |
Mengaktifkan akselerasi Apple Metal GPU di macOS dan iOS. |
coreml |
Mengaktifkan backend Apple CoreML neural engine di perangkat Apple Silicon. |
vulkan |
Mengaktifkan akselerasi Vulkan compute shader untuk GPU modern di Linux/Windows/Android. |
opencl |
Mengaktifkan akselerasi OpenCL pada GPU yang kompatibel. |
cuda |
Mengaktifkan akselerasi NVIDIA CUDA di Linux/Windows. |
nnapi |
Mengaktifkan akselerasi Android Neural Networks API pada chipset perangkat yang didukung. |
2. .NET / C# (NuGet)
Pasang paket inti dari NuGet:
dotnet add package RustODotnet
Paket Bundel Model
Untuk menyertakan model bawaan yang ringan tanpa perlu mengelola file aset .mnn secara manual, pasang salah satu paket model resmi:
# Model default yang direkomendasikan: PP-OCRv6 Tiny (~6 MB total)
dotnet add package RustODotnet.Models.PPOCRv6.Tiny
# Atau paket model bahasa/tingkat khusus:
dotnet add package RustODotnet.Models.PPOCRv6.Small
dotnet add package RustODotnet.Models.PPOCRv5.Latin
dotnet add package RustODotnet.Models.PPOCRv4.Japanese
3. React Native (npm / yarn / pnpm)
Pasang paket React Native npm:
# Menggunakan npm
npm install react-native-rusto
# Menggunakan Yarn
yarn add react-native-rusto
# Menggunakan pnpm
pnpm add react-native-rusto
Konfigurasi iOS (ios/Podfile)
Tambahkan pod model OCR pilihan Anda di dalam target aplikasi pada ios/Podfile:
target 'YourApp' do
# Tambahkan pod model:
pod 'RustO-Models-PPOCRv6-Tiny' # ~6 MB (Direkomendasikan)
# atau pod 'RustO-Models-PPOCRv6-Small'
# atau pod 'RustO-Models-PPOCRv5-Mobile'
end
Kemudian jalankan instalasi CocoaPods:
cd ios && pod install
Konfigurasi Android (android/build.gradle & android/app/build.gradle)
Pada root android/build.gradle atau settings.gradle, pastikan repositori JitPack sudah ditambahkan:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven { url 'https://jitpack.io' }
}
}
Pada android/app/build.gradle, tambahkan dependensi paket model:
dependencies {
implementation 'com.github.byrizki.rusto-rs:rusto-models-ppocrv6-tiny:v0.2.4'
}
4. iOS (Swift / CocoaPods)
Pada file Podfile proyek Anda:
target 'YourApp' do
use_frameworks!
# Runtime inti
pod 'RustO'
# Bundel model
pod 'RustO-Models-PPOCRv6-Tiny'
end
Jalankan perintah pod install.
5. Android (Kotlin / Gradle)
Pastikan repositori JitPack terdaftar pada settings.gradle:
repositories {
maven { url 'https://jitpack.io' }
}
Tambahkan pustaka inti dan paket model pada build.gradle aplikasi Anda:
dependencies {
// Runtime OCR inti dengan library native JNI
implementation 'com.github.byrizki.rusto-rs:rusto-android:v0.2.4'
// Bundel model PP-OCRv6 Tiny
implementation 'com.github.byrizki.rusto-rs:rusto-models-ppocrv6-tiny:v0.2.4'
}
6. C / Native Shared Libraries & Headers
Pustaka bersama dinamis pra-rakit dan file header C dirilis pada setiap GitHub Release:
- Linux:
librusto.so(x86_64,aarch64) - macOS:
librusto.dylib(Universalarm64+x86_64) - Windows:
rusto.dll,rusto.lib(x64,arm64) - Header C:
librusto.h
Untuk melakukan kompilasi dari kode sumber dengan fitur FFI aktif:
cargo build --release --features ffi
File pustaka dinamis dan statis hasil kompilasi akan berada di direktori target/release/.