Mulai Berlatih

Pemasangan Proyek Baru

Anda dapat menggunakan Pengaturan Bantu AI kami untuk menginstal Capacitor+. Tambahkan Capgo kemampuan ke alat AI Anda menggunakan perintah 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 suka Pengaturan Manual, instal paket-paket dengan menjalankan perintah-perintah berikut dan ikuti instruksi spesifik platform di bawah ini:

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

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 Capacitor+ paket

   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 API yang sama seperti Capacitor resmi. Impor dan code Anda tetap sama persis.

Penggunaan

Karena Capacitor+ kompatibel dengan API-, code Anda yang ada tidak perlu diubah:

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-Plugin Resmi Capacitor

Semua plugin resmi Capacitor berjalan 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-Plugin Capgo

Plugin-Plugin Capgo 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 Cara 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 Actions fetch latest changes from ionic-team/capacitor
2. Pembuatan PR: Perubahan disarankan sebagai permintaan pull ke plus cabang
3. Validasi CI: Seluruh suite tes berjalan (lint, unit tests, build iOS, build Android)
4. Pengujian Keamanan: Analisis berbasis AI memeriksa keamanan dan perubahan yang mengganggu
5. Menggabungkan Otomatis: Hanya jika CI berhasil dan pengujian keamanan disetujui
6. Meng-publish Otomatis: New version published to npm under @capacitor-plus/*

Rincian Ulasan Keamanan

Setiap sinkronisasi upstream dianalisis untuk:

Periksa	Apa yang Dapat Ditemukan
Keamanan	Penggunaan perintah injeksi, XSS, traversal jalur, rahasia yang ditetapkan secara keras
Pembongkaran Perubahan	API yang dihapus/bernama berbeda, tanda tangan yang berubah, perubahan konfigurasi
Stabilitas	Pengacuan null, kecuali exception yang tidak dihandle, kondisi balap, kebocoran memori
Keamanan Data	Skenario kehilangan data, pelanggaran privasi, penyimpanan tidak aman
Code Integritas	code yang dienkripsi, panggilan jaringan mencurigakan, pintu belakang

Pertimbangan

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

Mengirimkan PR Anda

PR Anda terjebak di repositori resmi Capacitor? Dapatkan PR Anda di-merge di Capacitor+:

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

2. Atau submit 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 produksi?

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

Apakah plugin resmi saya masih akan berfungsi?

Ya. Semua @capacitor/* plugin berfungsi dengan Capacitor+ tanpa perlu modifikasi.

Apa jika upstream mengeluarkan perubahan yang mengganggu?

Uji coba keamanan AI memflag perubahan yang mengganggu untuk tinjauan manual. Anda akan melihat perubahan yang terdokumentasi sebelum mereka diintegrasikan.

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! PRs sangat welcome. Anda bisa mengirimkan perbaikan langsung atau meminta PR upstream tertentu untuk diintegrasikan.

Teruskan dari Getting Started

Jika Anda menggunakan Getting Started untuk merencanakan kerja native plugin, hubungkan dengan Menggunakan Capacitor+ (@capacitor-plus) Packages untuk kemampuan native di Menggunakan Capacitor+ (@capacitor-plus) Packages, Capgo Direktori Plugin untuk alur kerja produk di Capgo Direktori Plugin, Capacitor Plugin oleh Capgo untuk detail implementasi di Capacitor Plugins oleh Capgo, Menambahkan atau Mengupdate Plugins untuk detail implementasi di Menambahkan atau Mengupdate Plugins, dan Alternatif Plugin Enterprise Ionic untuk alur kerja produk di Alternatif Plugin Enterprise Ionic.