Getting Started

Penginstalan Proyek Baru

Anda dapat menggunakan Pengaturan Bantuan AI untuk menginstal Capacitor+. Tambahkan keterampilan Capgo ke alat AI Anda menggunakan perintah berikut:

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

Kemudian 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 Setup 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 Official Capacitor

Jika Anda memiliki proyek Capacitor yang sudah ada, migrasi 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

Pesan

No code changes required! Capacitor+ has the same API as official Capacitor. Your imports and code remain exactly the same.

Penggunaan

Karena Capacitor+ kompatibel dengan API-, maka pengaturan code Anda 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-Plugin Resmi Capacitor

Semua plugin resmi Capacitor 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-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();

How the Sync Works

┌─────────────────────┐     ┌──────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  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. PR Pembuatan: Perubahan disarankan sebagai permintaan pull ke plus cabang
3. Validasi CI: Seluruh suite tes berjalan (lint, unit tes, build iOS, build Android)
4. Pengujian Keamanan: Analisis berbasis AI memeriksa keamanan dan perubahan yang mengganggu
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:

Periksa	Apa yang Dapat Ditemukan
Keamanan	: Label UI untuk bagian keamanan produk/pricing. Dilihat di: halaman enterprise.astro. Kunci pesan `enterprise_hero_security_label` (Label Keamanan Hero Enterprise).
Penyusupan perintah, XSS, penyusupan jalur, rahasia yang dihardcodekan	Perubahan API yang dihapus/bernama lain, perubahan tanda tangan, perubahan konfigurasi
Stabilitas	Referensi null, kecuali tidak terhandle, kondisi balap, kebocoran memori
Keamanan Data	Skenario kehilangan data, pelanggaran privasi, penyimpanan tidak aman
Code Integritas	Kode yang dienkripsi code, panggilan jaringan yang 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

Memiliki PR yang terjebak di repositori resmi Capacitor? Dapatkan diterima dalam Capacitor+:

1. Buka isu dalam repositori Capacitor+ mengacu ke PR upstream Anda

2. Atau submit secara langsung sebagai PR ke cabang plus Tim akan melakukan review, menjalankan CI, dan meneruskan jika berhasil

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

Pertanyaan Umum

context: Halaman/area: Capgo Builder / produk halaman build cloud native. Peran: Judul bagian atau tagline. Dilihat di: halaman native-build.astro. Kunci pesan `native_build_builder_faq_eyebrow` (FAQ Pembuat Build Native). | Halaman/area: Halaman pemasaran solusi Capgo. Peran: Judul bagian atau halaman. Dilihat di: halaman solutions/cordova-to-capacitor.astro. Kunci pesan `solutions_cordova_to_capacitor_faq_title` (Judul FAQ Solusi Cordova Ke Capacitor).

Apakah ini sudah siap digunakan dalam produksi?

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 @capacitor/* plugin berfungsi dengan Capacitor+ tanpa perlu konfigurasi tambahan.

Bagaimana jika upstream mengeluarkan perubahan yang memecah konsistensi?

Uji coba keamanan AI mendeteksi perubahan yang memecah konsistensi untuk diulas secara manual. Anda akan melihat perubahan yang terdokumentasi sebelum diintegrasikan.

Bagaimana saya melaporkan masalah?

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

Apakah saya bisa berkontribusi?

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

Teruskan dari Getting Started

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