Mulai

Instalasi Proyek Baru

1. Pasang 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

Mengimpor dari Resmi Capacitor

Jika Anda memiliki proyek Capacitor yang sudah ada, mengimpor ke Capacitor+ sangatlah mudah:

1. Hapus paket resmi

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

2. Pasang 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 ada perubahan code yang diperlukan! Capacitor+ memiliki fitur yang sama seperti API resmi Capacitor. Impor dan code Anda tetap sama.

Penggunaan

Karena Capacitor+ kompatibel dengan API-, code Anda yang ada masih 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 berfungsi 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

Capgo plugin berfungsi 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();

Bagaimana Skenario Sinkronisasi Berfungsi

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

1. Sinkronisasi Harian: GitHub Aksi mengambil perubahan terbaru dari ionic-team/capacitor
2. Pembuatan PR: Perubahan disampaikan sebagai permintaan pull ke plus Cabang
3. Validasi CI: Seluruh tes penuh berjalan (lint, unit tests, build iOS, build Android)
4. Uji Keamanan: Analisis berbasis AI memeriksa keamanan dan perubahan yang dapat memecahkan
5. Auto-Merge: Hanya jika CI berhasil dan tinjauan keamanan disetujui
6. Auto-Publish: Versi baru dipublikasikan ke npm di @capacitor-plus/*

Rincian Tinjauan Keamanan

Setiap sinkronisasi upstream dianalisis untuk:

Check	Apa yang Dapat Ditemukan
Keamanan	Injeksi perintah, XSS, navigasi traversal, rahasia yang dihardcode
Perubahan Penting	API yang dihapus/berubah, perubahan tanda tangan, perubahan konfigurasi
Stabilitas	Referensi null, kecuali tidak terhandle, kondisi balapan, kebocoran memori
Keamanan Data	Skenario kehilangan data, pelanggaran privasi, penyimpanan tidak aman
Code Keutuhan	Obfusasi code, panggilan jaringan mencurigakan, pintu belakang

Peringatan

Jika ada masalah yang ditemukan, PR akan ditandai untuk tinjauan manual dan TIDAK akan di-merge secara otomatis. Hal ini memastikan Anda selalu mendapatkan rilis yang stabil dan aman.

Mengirimkan PR Anda

PR Anda terjebak di repositori resmi Capacitor? Ambilnya di Capacitor+:

1. Buka isu di Capacitor+ repo menghubungkan ke PR upstream Anda

2. Atau kirim secara langsung sebagai PR ke plus cabang

3. Tim akan melakukan review, menjalankan CI, dan menggabungkan jika berhasil

Dengan cara ini Anda dan orang lain dapat menikmati hasil kerja Anda segera tanpa harus menunggu siklus rilis upstream.

FAQ

Apakah ini sudah siap digunakan?

Ya. Capacitor+ digunakan dalam aplikasi produksi. Setiap rilis melewati tes suite yang sama seperti Capacitor resmi, plus analisis keamanan tambahan.

Apakah plugin saya resmi masih akan berfungsi?

Ya. Semua plugin berfungsi dengan __CAPGO_KEEP_0__+ secara otomatis. @capacitor/* plugins work with Capacitor+ out of the box.

Bagian berjudul “Apa jika rilis upstream mengeluarkan perubahan yang memecah?”

Bagaimana saya melaporkan masalah?

Bagian berjudul “Bagaimana saya melaporkan masalah?”

Laporkan masalah di Capacitor + GitHub repo. Untuk masalah yang juga mempengaruhi Capacitor resmi, kami akan membantu mengkoordinasikan upstream.

Apakah saya bisa berkontribusi?

Tentu saja! PRs selalu diterima. Anda bisa mengirimkan perbaikan langsung atau meminta PR upstream tertentu untuk diintegrasikan.