Memulai

Instalasi Proyek Baru

1. Instal paket inti

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

2. Tambahkan 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. Tambahkan 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 memiliki proyek Capacitor yang sudah ada, migrasi ke Capacitor+ sangat 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 perubahan kode! Capacitor+ memiliki API yang sama dengan Capacitor resmi. Impor dan kode Anda tetap sama persis.

Penggunaan

Karena Capacitor+ kompatibel dengan API, kode Anda yang ada akan 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 Capacitor resmi bekerja dengan lancar:

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. Sinkronisasi Harian: GitHub Actions mengambil perubahan terbaru dari ionic-team/capacitor
2. Pembuatan PR: Perubahan diusulkan sebagai pull request ke cabang plus
3. Validasi CI: Test suite lengkap berjalan (lint, unit tests, iOS build, Android build)
4. Tinjauan Keamanan: Analisis bertenaga AI memeriksa kerentanan dan perubahan yang merusak
5. Auto-Merge: Hanya jika CI lulus DAN tinjauan keamanan menyetujui
6. Auto-Publish: Versi baru dipublikasikan ke npm di bawah @capacitor-plus/*

Detail Tinjauan Keamanan

Setiap sinkronisasi upstream dianalisis untuk:

Pemeriksaan	Yang Ditangkap
Keamanan	Command injection, XSS, path traversal, hardcoded secrets
Perubahan yang Merusak	API yang dihapus/diubah namanya, signature yang diubah, perubahan konfigurasi
Stabilitas	Null dereferences, exception yang tidak ditangani, race conditions, memory leaks
Keamanan Data	Skenario kehilangan data, pelanggaran privasi, penyimpanan tidak aman
Integritas Kode	Kode yang disamarkan, panggilan jaringan mencurigakan, backdoors

Perhatian

Jika ada masalah terdeteksi, PR akan ditandai untuk ditinjau secara manual dan TIDAK akan digabungkan secara otomatis. Ini memastikan Anda selalu mendapatkan rilis yang stabil dan aman.

Mengirimkan PR Anda

Memiliki PR yang terjebak di repo Capacitor resmi? Dapatkan merge di Capacitor+:

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

2. Atau kirimkan langsung sebagai PR ke cabang plus

3. Tim akan meninjau, menjalankan CI, dan menggabungkan jika lulus

Dengan cara ini Anda dan orang lain dapat mengambil manfaat dari pekerjaan Anda segera tanpa menunggu siklus rilis upstream.

FAQ

Apakah ini siap untuk produksi?

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

Apakah plugin resmi saya masih akan bekerja?

Ya. Semua plugin @capacitor/* bekerja dengan Capacitor+ langsung dari kotak.

Bagaimana jika upstream merilis perubahan yang merusak?

Tinjauan keamanan AI menandai perubahan yang merusak untuk ditinjau secara manual. Anda akan melihat perubahan yang didokumentasikan sebelum digabungkan.

Bagaimana cara melaporkan masalah?

Ajukan issue di repo GitHub Capacitor+. Untuk masalah yang juga mempengaruhi Capacitor resmi, kami akan membantu koordinasi upstream.

Bisakah saya berkontribusi?

Tentu saja! PR sangat diterima. Anda dapat mengirimkan perbaikan secara langsung atau meminta agar PR upstream tertentu digabungkan.