Panduan Memulai

Mulai cepat

bun add @capgo/capacitor-plus
npx cap sync

Kesalahan umum

• Ganti semua depedensi @capacitor/*.
• Regenerasi native project setelah migrasi.
• Baca release notes sebelum melakukan bump.

Instalasi Project Baru

Anda bisa menggunakan AI-Assisted Setup kami untuk menginstal Capacitor. Tambahkan skill Capgo ke tool AI Anda menggunakan command berikut:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Lalu gunakan prompt berikut:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capacitor-plus/core`, `@capacitor-plus/cli`, `@capacitor-plus/android`, and `@capacitor-plus/ios` packages in my project.

Jika Anda lebih memilih Manual Setup, instal package dengan menjalankan command berikut dan ikuti instruksi spesifik platform di bawah ini:

1. Instal core package

   npm install @capacitor-plus/core @capacitor-plus/cli

2. Tambah paket platform

   npm install @capacitor-plus/android  # for Android
   npm install @capacitor-plus/ios      # for iOS

3. Inisialisasi Capacitor

   npm

   npx cap init

   pnpm

   pnpm cap init

   yarn

   yarn cap init

   bun

   bunx cap init

4. Tambah platform

   npm

   npx cap add android

   pnpm

   pnpm cap add android

   yarn

   yarn cap add android

   bun

   bunx cap add android

   npm

   npx cap add ios

   pnpm

   pnpm cap add ios

   yarn

   yarn cap add ios

   bun

   bunx cap add ios

Migrasi dari Capacitor Resmi

Jika Anda sudah memiliki proyek Capacitor, migrasi ke Capacitor+ sangatlah mudah:

1. Hapus paket resmi

   npm uninstall @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios

2. Instal paket Capacitor+

   npm install @capacitor-plus/core @capacitor-plus/cli
   npm install @capacitor-plus/android  # if using Android
   npm install @capacitor-plus/ios      # if using iOS

3. Sinkronkan proyek Anda

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

Catatan

Tidak perlu ada perubahan code! Capacitor+ memiliki API yang sama dengan Capacitor resmi. Import dan code Anda tetap sama persis.

Penggunaan

Karena Capacitor+ sudah API-compatible, code Anda yang sudah ada tetap berfungsi tanpa perubahan:

import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';

// Check platform
const platform = Capacitor.getPlatform();
console.log('Running on:', platform);

// Check if native
if (Capacitor.isNativePlatform()) {
  console.log('Running on native platform');
}

// Register a custom plugin
const MyPlugin = registerPlugin('MyPlugin');

Dengan Plugin Capacitor Resmi

Semua plugin resmi Capacitor bekerja dengan mulus:

import { Camera, CameraResultType } from '@capacitor/camera';
import { Geolocation } from '@capacitor/geolocation';
import { Storage } from '@capacitor/preferences';

// Camera
const photo = await Camera.getPhoto({
  quality: 90,
  resultType: CameraResultType.Uri
});

// Geolocation
const position = await Geolocation.getCurrentPosition();

// Storage
await Storage.set({ key: 'name', value: 'John' });

Dengan Plugin Capgo

Plugin Capgo bekerja sempurna dengan Capacitor+:

import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { ScreenOrientation } from '@capgo/capacitor-screen-orientation';
import { CapacitorFlash } from '@capgo/capacitor-flash';

// Live updates
await CapacitorUpdater.notifyAppReady();

// Screen orientation
await ScreenOrientation.lock({ orientation: 'portrait' });

// Flashlight
await CapacitorFlash.toggle();

Cara Kerja Sinkronisasi

┌─────────────────────┐     ┌──────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  ionic-team/        │     │  CI/CD           │     │  Claude Code     │     │  npm publish    │
│  capacitor          │────▶│  Pipeline        │────▶│  Security Review │────▶│  @capacitor-plus│
│  (upstream)         │     │  (daily sync)    │     │  (AI analysis)   │     │  packages       │
└─────────────────────┘     └──────────────────┘     └──────────────────┘     └─────────────────┘

1. Daily Sync: GitHub Actions mengambil perubahan terbaru dari ionic-team/capacitor
2. Pembuatan PR: Perubahan diajukan sebagai pull request ke plus branch
3. Validasi CI: Test suite lengkap dijalankan (lint, unit test, iOS build, Android build)
4. Review Keamanan: Analisis berbasis AI memeriksa kerentanan dan breaking changes
5. Auto-Merge: Hanya jika CI lulus DAN review keamanan disetujui
6. Auto-Publish: Versi baru dipublikasikan ke npm di bawah @capacitor-plus/*

Detail Review Keamanan

Setiap sinkronisasi upstream dianalisis untuk:

Periksa	Apa yang Terdeteksi
Keamanan	Injeksi perintah, XSS, path traversal, hardcoded secrets
Perubahan Penting	API yang dihapus/diubah namanya, perubahan signature, perubahan konfigurasi
Stabilitas	Null dereference, exception yang tidak tertangani, race condition, kebocoran memori
Keamanan Data	Skenario kehilangan data, pelanggaran privasi, penyimpanan tidak aman
Integritas Code	code yang terobfuskasi, panggilan jaringan mencurigakan, backdoor

Peringatan

Jika ada masalah terdeteksi, PR akan ditandai untuk review manual dan TIDAK akan di-auto-merge. Ini memastikan Anda selalu mendapatkan rilis yang stabil dan aman.

Mengirimkan PR Anda

PR Anda stuck di repo resmi Capacitor? Dapatkan merge di Capacitor+:

1. Buka issue di dalam repo Capacitor+ menautkan ke upstream PR Anda

2. Atau submit langsung sebagai PR ke plus branch

3. Tim akan meninjau, menjalankan CI, dan merge jika lolos

Dengan cara ini, Anda dan orang lain bisa langsung mendapat manfaat dari hasil kerja Anda tanpa menunggu siklus rilis upstream.

FAQ

Apakah ini sudah siap untuk production?

Ya. Capacitor+ digunakan di aplikasi production. Setiap rilis melewati test suite yang sama dengan Capacitor resmi, plus analisis keamanan tambahan.

Apakah plugin resmi saya tetap berfungsi?

Ya. Semua @capacitor/* plugin berfungsi dengan Capacitor+ secara langsung.

Bagaimana jika upstream merilis breaking change?

AI security review menandai breaking change untuk ditinjau manual. Anda akan melihat perubahannya terdokumentasi sebelum di-merge.

Bagaimana cara melaporkan issue?

Laporkan issue di repo Capacitor+ GitHub. Untuk issue yang juga berdampak pada Capacitor resmi, kami akan membantu berkoordinasi dengan upstream.

Bisakah saya berkontribusi?

Tentu saja! PR sangat kami terima. Anda bisa langsung mengirimkan perbaikan atau meminta agar PR upstream tertentu di-merge.

Lanjutkan dari Getting Started

Jika Anda menggunakan Panduan Memulai untuk merencanakan pekerjaan plugin native, hubungkan dengan Menggunakan Package Capacitor+ (@capacitor-plus) untuk kapabilitas native dalam Menggunakan Paket Capacitor+ (@capacitor-plus), 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.