Lompat ke konten utama
Logo Capgo
Kembali ke plugin
@capacitor-plus/core
Tutorial
oleh github.com/Cap-go

Capacitor+ Core

Capacitor+ adalah sebuah fork otomatis, selalu sinkron dari Capacitor dengan PR komunitas yang diintegrasikan dan rilis cepat

Downloads/bulan

687

GitHub Bintang

17

Petunjuk

Tutorial pada Capacitor+ Core

Menggunakan Capacitor+ (@capacitor-plus) Paket

Capacitor+ adalah salinan otomatis, selalu sinkron, dari Capacitor dipelihara oleh CapgoCapacitor menyediakan pengganti yang dapat digunakan secara langsung untuk paket resmi Capacitor dengan satu kelebihan utama: Kerja sama PR dan perbaikan yang lebih cepat.

Mengapa Capacitor+ Ada

Tim Ionic menjaga Capacitor dengan prioritas dan jadwal rilis mereka sendiri. Ini berarti kontribusi komunitas - perbaikan bug, peningkatan, dan fitur - dapat menunggu bulan-bulan atau bahkan tahun-tahun untuk diintegrasikan. Beberapa tidak pernah berhasil.

Capacitor+ menyelesaikan masalah ini dengan:

  1. Mengintegrasikan PR dari Fork - PR yang berharga yang terjebak di antrian upstream secara aktif diintegrasikan
  2. Sinkronisasi Terus-Menerus - Setiap perubahan dari upstream Capacitor secara otomatis di pull, diuji, dan diverifikasi
  3. Rilis Cepat - Ketika perubahan lolos CI, mereka secara otomatis dipublikasikan ke npm di bawah @capacitor-plus scope
  4. Komunitas-Pertama - Kontribusi Anda berarti dan mendapatkan prioritas
  5. Diperiksa Keamanan - Setiap perubahan dianalisis oleh AI untuk kelemahan keamanan, perubahan yang memecah, dan risiko stabilitas

Paket yang Tersedia

Paket Deskripsi
@capacitor-plus/core Libray Runtime Utama
@capacitor-plus/cli Antarmuka Perintah Baris
@capacitor-plus/android Runtime Android
@capacitor-plus/ios Runtime iOS

Pemasangan

Proyek Baru

Untuk proyek baru, cukup gunakan paket Capacitor+ alih-alih yang resmi:

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

Lalu inisialisasi proyek Anda:

npx cap init
npx cap add android
npx cap add ios

Migrasi dari Official Capacitor

Untuk memigrasikan proyek yang sudah ada dari official Capacitor ke Capacitor+:

# Remove official packages
npm uninstall @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios

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

Karena Capacitor+ adalah pengganti yang dapat digunakan langsung dengan API, tidak ada perubahan code yang diperlukan. Impor Anda tetap sama:

// These imports work the same with Capacitor+
import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';

Bagaimana Cara Kerjanya

┌─────────────────────┐     ┌──────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  ionic-team/        │     │  CI/CD           │     │  Claude Code     │     │  npm publish    │
│  capacitor          │────▶│  Pipeline        │────▶│  Security Review │────▶│  @capacitor-plus│
│  (upstream)         │     │  (daily sync)    │     │  (AI analysis)   │     │  packages       │
└─────────────────────┘     └──────────────────┘     └──────────────────┘     └─────────────────┘
  1. Sinkronisasi Harian: Aksi GitHub mengambil perubahan terbaru dari ionic-team/capacitor
  2. Pembuatan PR: Perubahan diusulkan sebagai pull request ke plus cabang
  3. Validasi CI: Seluruh tes penuh berjalan (lint, unit tests, build iOS, build Android)
  4. Ulasan Code Claude : Analisis keamanan komprehensif yang dipimpin AI untuk:
    • Kekeliruan keamanan (injeksi, XSS, dll.)
    • Perubahan API yang memecah
    • Risiko kegagalan dan masalah stabilitas
    • Kesulitan integritas dan privasi data
    • Polanya code berbahaya
  5. Auto-Merge : Hanya jika CI berhasil DAN Claude menyetujui (tidak ada masalah yang terdeteksi)
  6. Menerbitkan Otomatis: Versi baru diterbitkan di npm di bawah @capacitor-plus/*

Pengujian Keamanan

Setiap sinkronisasi upstream dianalisis untuk:

Periksa Deskripsi
Keamanan Injeksi perintah, XSS, navigasi melalui jalur, rahasia yang ditetapkan secara keras, dll.
Pembaharuan yang Mengganggu API yang dihapus/bernama, tanda tangan yang berubah, perubahan format konfigurasi
Stabilitas Referensi null, kecuali tidak dihandle, kondisi balap, kebocoran memori
Keamanan Data Skenario kehilangan data, pelanggaran privasi, penyimpanan tidak aman
Code Integritas code yang dienkripsi, panggilan jaringan yang mencurigakan, pintu belakang

Jika ada masalah yang ditemukan, PR akan ditandai untuk tinjauan manual dan TIDAK akan di-merge secara otomatis.

Mau PR Anda Diterima?

PR Anda terjebak di repositori resmi Capacitor? Berikut cara untuk memasukkannya ke Capacitor+:

  1. Buka isu di Capacitor+ repo menghubungkan ke PR upstream Anda
  2. atau submit PR secara langsung kepada cabang plus cabang
  3. Tim akan memeriksa dan mengintegrasikan perubahan jika berhasil

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

Keuntungan

  • PR yang Terjebak Sekarang: Perbaikan dan fitur komunitas yang menunggu upstream diintegrasikan
  • Tetap Terkini: Dapatkan perbaikan upstream segera setelah berhasil CI
  • Keamanan Utama: Setiap perubahan dipemeriksa untuk keamanan dan risiko stabilitas
  • Rilis Terverifikasi: Hanya perubahan yang lolos uji CI dan tinjauan keamanan AI yang dipublikasikan
  • Penyempurnaan Langsung: Sama seperti API sebagai Capacitor, hanya dengan lingkup paket yang berbeda
  • Suara Anda Berharga: Kirimkan PR Anda sendiri atau minta PR upstream tertentu untuk diintegrasikan

Contoh: Menggunakan Capacitor+ dengan Plugin

Tidak ada plugin resmi Capacitor yang tidak berfungsi dengan Capacitor+:

import { Capacitor } from '@capacitor/core';
import { Camera, CameraResultType } from '@capacitor/camera';
import { Geolocation } from '@capacitor/geolocation';

// Everything works exactly the same
const platform = Capacitor.getPlatform();

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

const position = await Geolocation.getCurrentPosition();

Plugin Capgo juga berfungsi dengan sempurna dengan Capacitor+:

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

// Use Capgo plugins with Capacitor+
await CapacitorUpdater.notifyAppReady();
await ScreenOrientation.lock({ orientation: 'portrait' });

Itu saja! Anda sekarang memiliki versi yang lebih cepat diperbarui dari Capacitor dengan perbaikan komunitas yang diintegrasikan lebih cepat. Aplikasi Anda akan mendapatkan manfaat dari perbaikan bug dan fitur tanpa harus menunggu siklus rilis resmi

Teruskan dari Menggunakan Capacitor+ (@capacitor-plus) Paket

Jika Anda menggunakan Menggunakan Capacitor+ (@capacitor-plus) Paket untuk merencanakan pekerjaan plugin native, hubungkannya dengan Capacitor+ untuk detail implementasi di Capacitor+ 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 Enterprise Ionic untuk alur kerja produk di Alternatif Plugin Enterprise Ionic.