Langsung ke konten utama
@capacitor-plus/core Alat Developer Open source

Capacitor+ Core plugin Capacitor

Capacitor+ adalah fork Capacitor yang otomatis dan selalu tersinkron, dengan PR komunitas yang sudah di-merge dan rilis cepat

Instal

bun add @capacitor-plus/core bunx cap sync
npm, pnpm atau yarn
  • npm install @capacitor-plus/core
  • pnpm add @capacitor-plus/core
  • yarn add @capacitor-plus/core

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:

  1. Menggabungkan PR dari fork - PR berharga yang tertahan di antrean upstream secara aktif di-merge
  2. Sinkronisasi Kontinu - Setiap perubahan dari Capacitor upstream otomatis ditarik, diuji, dan diverifikasi
  3. Rilis Cepat - Saat perubahan lolos CI, semuanya otomatis dipublikasikan ke npm di bawah @capacitor-plus cakupan
  4. Utamakan Komunitas - Kontribusi Anda penting dan diprioritaskan
  5. 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       │
└─────────────────────┘     └──────────────────┘     └──────────────────┘     └─────────────────┘
  1. Daily Sync: Aksi GitHub mengambil perubahan terbaru dari ionic-team/capacitor
  2. Pembuatan PR: Perubahan diusulkan sebagai pull request ke plus branch
  3. Validasi CI: Test suite lengkap dijalankan (lint, unit test, iOS build, Android build)
  4. 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
  5. Auto-Merge: Hanya jika CI lulus DAN Claude menyetujui (tidak ada issue terdeteksi)
  6. 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+:

  1. Buka issue di dalam repo Capacitor+ dengan tautan ke PR upstream Anda
  2. Atau kirim PR secara langsung ke dalam plus branch
  3. 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.

FAQ

FAQ plugin Capacitor+ Core

Bagaimana cara menginstal plugin Capacitor+ Core di aplikasi Capacitor?

Jalankan "bun add @capacitor-plus/core" (atau "npm install @capacitor-plus/core"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android mengenali code native. Impor dari "@capacitor-plus/core" di code aplikasi Anda.

Apakah @capacitor-plus/core bekerja dengan React, Vue, dan Angular?

Ya. Capacitor+ Core adalah paket Capacitor, jadi bekerja dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript murni.

Versi Capacitor mana yang didukung @capacitor-plus/core?

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

Apakah @capacitor-plus/core gratis dan open source?

Ya. Kode sumber code tersedia publik di GitHub pada https://github.com/Cap-go/capacitor-plus/ dan paketnya gratis diinstal dari npm. Laporan bug dan pull request selalu diterima.

Bisakah saya memperbarui code yang menggunakan Capacitor+ Core tanpa review App Store?

Instalasi atau upgrade plugin akan mengubah native code, jadi butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin bisa langsung dikirim lewat live updates Capgo.

Rilis perubahan Capacitor+ Core tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, live updates Capgo akan mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo