Files
ssw c303c315e5 rocr: rusto-rs 源码入库(上游 v0.2.5 基线 57609fc + 本地补丁)
- 源码 316 文件收编为 rusto-rs/ 文件夹,随本仓库管理
- 移除内部 .git(补丁已存档 docs/rusto-rs-metal-patch-20260912.patch,上游可随时 re-clone)
- target/ 与 docs/.yarn 缓存不入库;本地改动:ROCR_* 环境变量调优 + Metal 链接修复 + 预处理测试脚本
2026-09-12 17:30:04 +08:00

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.
icon
i-ph-download
title description
Instalasi - RustO! 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 (Universal arm64 + 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/.