Panduan
Cara menggunakan Capacitor+ Core di Capacitor
Menggunakan Package Capacitor+ (@capacitor-plus)
Capacitor+ adalah fork otomatis yang selalu tersinkronisasi dari Capacitor dipelihara oleh Capgo. Ini adalah pengganti langsung (drop-in) untuk paket resmi Capacitor dengan satu keunggulan utama: PR dan perbaikan dari komunitas di-merge lebih cepat.
Mengapa Capacitor+ Ada
Tim Ionic mengelola Capacitor sesuai prioritas dan jadwal rilis mereka sendiri. Artinya, kontribusi komunitas—perbaikan bug, peningkatan, dan fitur baru—bisa menunggu berbulan-bulan bahkan bertahun-tahun untuk di-merge. Beberapa bahkan tidak pernah di-merge sama sekali.
Capacitor+ mengatasi masalah ini dengan:
- Menggabungkan PR dari fork - PR berharga yang tertahan di antrean upstream secara aktif di-merge
- Sinkronisasi Kontinu - Setiap perubahan dari Capacitor upstream otomatis ditarik, diuji, dan diverifikasi
- Rilis Cepat - Saat perubahan lolos CI, semuanya otomatis dipublikasikan ke npm di bawah
@capacitor-pluscakupan - Utamakan Komunitas - Kontribusi Anda penting dan diprioritaskan
- Tinjauan Keamanan - Setiap perubahan dianalisis oleh AI untuk kerentanan keamanan, perubahan yang merusak, dan risiko stabilitas
Package yang Tersedia
| Paket | Deskripsi |
|---|---|
@capacitor-plus/core |
Perpustakaan runtime inti |
@capacitor-plus/cli |
Antarmuka baris perintah |
@capacitor-plus/android |
Runtime Android |
@capacitor-plus/ios |
Runtime iOS |
Instalasi
Proyek Baru
Untuk proyek baru, cukup gunakan paket Capacitor+ alih-alih paket resmi:
npm install @capacitor-plus/core @capacitor-plus/cli
npm install @capacitor-plus/android # for Android
npm install @capacitor-plus/ios # for iOS
Lalu inisialisasi proyek Anda:
npx cap init
npx cap add android
npx cap add ios
Migrasi dari Capacitor Resmi
Untuk memigrasikan proyek yang ada dari Capacitor resmi ke Capacitor+:
# Remove official packages
npm uninstall @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios
# Install Capacitor+ packages
npm install @capacitor-plus/core @capacitor-plus/cli
npm install @capacitor-plus/android # if using Android
npm install @capacitor-plus/ios # if using iOS
Karena Capacitor+ adalah pengganti langsung dengan API yang sama, tidak diperlukan perubahan code. Impor Anda tetap sama:
// These imports work the same with Capacitor+
import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';
Cara Kerjanya
┌─────────────────────┐ ┌──────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ ionic-team/ │ │ CI/CD │ │ Claude Code │ │ npm publish │
│ capacitor │────▶│ Pipeline │────▶│ Security Review │────▶│ @capacitor-plus│
│ (upstream) │ │ (daily sync) │ │ (AI analysis) │ │ packages │
└─────────────────────┘ └──────────────────┘ └──────────────────┘ └─────────────────┘
- Daily Sync: Aksi GitHub mengambil perubahan terbaru dari
ionic-team/capacitor - Pembuatan PR: Perubahan diusulkan sebagai pull request ke
plusbranch - Validasi CI: Test suite lengkap dijalankan (lint, unit test, iOS build, Android build)
- Review Code oleh Claude: Analisis keamanan komprehensif berbasis AI memeriksa:
- Kerentanan keamanan (injection, XSS, dll.)
- Perubahan breaking pada API
- Risiko crash dan masalah stabilitas
- Integritas data dan masalah privasi
- Pola code yang berbahaya
- Auto-Merge: Hanya jika CI lulus DAN Claude menyetujui (tidak ada issue terdeteksi)
- Publikasi Otomatis: Versi baru dipublikasikan ke npm di bawah
@capacitor-plus/*
Review Keamanan
Setiap sinkronisasi upstream dianalisis untuk:
| Periksa | Deskripsi |
|---|---|
| Keamanan | Command injection, XSS, path traversal, secret yang di-hardcode, dll. |
| Perubahan Penting | API dihapus/di-rename, signature berubah, format config berubah |
| Stabilitas | Null dereference, exception yang tidak ditangani, race condition, memory leak |
| Keamanan Data | Skenario kehilangan data, pelanggaran privasi, penyimpanan tidak aman |
| Integritas Code | code yang diobfuscate, panggilan jaringan mencurigakan, backdoor |
Jika ada masalah terdeteksi, PR akan ditandai untuk review manual dan TIDAK akan di-merge otomatis.
Mau PR Anda di-merge?
PR kamu macet di repo resmi Capacitor? Begini cara memasukkannya ke Capacitor+:
- Buka issue di dalam repo Capacitor+ dengan tautan ke PR upstream Anda
- Atau kirim PR secara langsung ke dalam
plusbranch - Tim akan meninjaunya, menjalankan CI, dan menggabungkannya jika lolos
Dengan cara ini, Anda dan orang lain dapat langsung memanfaatkan pekerjaan Anda, tanpa menunggu siklus rilis upstream.
Keuntungan
- Dapatkan PR yang Macet Sekarang: Perbaikan dan fitur komunitas yang menunggu upstream telah digabungkan
- Tetap Terkini: Dapatkan perbaikan upstream segera setelah lolos CI
- Keamanan Terutama: Setiap perubahan ditinjau untuk kerentanan dan risiko stabilitas
- Rilis Terverifikasi: Hanya perubahan yang lolos tes CI DAN review keamanan AI yang dipublikasikan
- Pengganti drop-in: API yang sama dengan Capacitor, hanya beda scope package
- Suara Anda Berarti: Kirim PR Anda sendiri atau minta PR upstream tertentu untuk di-merge
Contoh: Menggunakan Capacitor+ dengan Plugin
Semua plugin resmi Capacitor berjalan mulus dengan Capacitor+:
import { Capacitor } from '@capacitor/core';
import { Camera, CameraResultType } from '@capacitor/camera';
import { Geolocation } from '@capacitor/geolocation';
// Everything works exactly the same
const platform = Capacitor.getPlatform();
const photo = await Camera.getPhoto({
resultType: CameraResultType.Uri
});
const position = await Geolocation.getCurrentPosition();
Plugin Capgo juga berjalan sempurna dengan Capacitor+:
import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { ScreenOrientation } from '@capgo/capacitor-screen-orientation';
// Use Capgo plugins with Capacitor+
await CapacitorUpdater.notifyAppReady();
await ScreenOrientation.lock({ orientation: 'portrait' });
Selesai! Sekarang Anda punya versi Capacitor yang update-nya lebih cepat, dengan perbaikan komunitas yang di-merge lebih cepat. Aplikasi Anda akan dapat perbaikan bug dan fitur tanpa menunggu siklus rilis resmi.
Lanjut dari Menggunakan Package Capacitor+ (@capacitor-plus)
Jika Anda menggunakan Menggunakan Package Capacitor+ (@capacitor-plus) untuk merencanakan pekerjaan plugin native, hubungkan dengan Capacitor+ untuk detail implementasinya di Capacitor+, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi pada Capacitor Plugins oleh Capgo Menambahkan atau Memperbarui Plugin untuk detail implementasi di Menambahkan atau Memperbarui Plugin, dan Alternatif Plugin Ionic Enterprise untuk alur kerja produk dalam Alternatif Plugin Ionic Enterprise.