Panduan Memulai

Instal

Anda bisa menggunakan AI-Assisted Setup untuk menginstal plugin ini. Tambahkan skill Capgo ke tool 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 `@capgo/capacitor-share-target` plugin in my project.

Jika Anda lebih suka Manual Setup, instal plugin dengan menjalankan perintah berikut dan ikuti instruksi khusus platform di bawah ini:

bun add @capgo/capacitor-share-target
bunx cap sync

Impor

import { CapacitorShareTarget } from '@capgo/capacitor-share-target';

Listen lebih awal (cold start)

Daftar shareReceived segera setelah aplikasi Anda booting, sebelum mengarahkan pengguna ke layar yang menggunakan konten bersama. Di iOS, layer native menyimpan event tersebut hingga JavaScript mengonsumsinya, sehingga mencakup share yang masuk saat WebView masih dalam proses startup.

import { CapacitorShareTarget } from '@capgo/capacitor-share-target';

const shareListener = await CapacitorShareTarget.addListener('shareReceived', (event) => {
  routeSharedPayload(event.title, event.texts, event.files);
});

// When tearing down the handler:
await shareListener.remove();

Konfigurasi appGroupId di capacitor.config dan gunakan App Group yang sama di Share Extension Anda. Lihat README plugin di GitHub untuk contoh extension code.

Masalah umum

• Setup Native: intents hanya akan berfungsi setelah mengikuti langkah manifest dan Xcode di README.
• Cold start: menampung share di buffer sampai router Anda siap.
• URI File: salin ke penyimpanan aplikasi sebelum upload, akses bisa kedaluwarsa.

Ikhtisar API

addListener

Pantau event shareReceived.

Mendaftarkan listener yang akan dipanggil saat konten dibagikan ke aplikasi dari aplikasi lain. Callback akan menerima data event berisi title, texts, dan files.

import { CapacitorShareTarget } from '@capgo/capacitor-share-target';

const listener = await CapacitorShareTarget.addListener('shareReceived', (event) => {
  console.log('Title:', event.title);
  console.log('Texts:', event.texts);
  event.files?.forEach(file => {
    console.log(`File: ${file.name} (${file.mimeType})`);
  });
});

// To remove the listener:
await listener.remove();

removeAllListeners

Hapus semua listener untuk plugin ini.

import { CapacitorShareTarget } from '@capgo/capacitor-share-target';

await CapacitorShareTarget.removeAllListeners();

getPluginVersion

Dapatkan versi plugin native Capacitor.

Mengembalikan versi saat ini dari implementasi plugin native.

import { CapacitorShareTarget } from '@capgo/capacitor-share-target';

const { version} = await CapacitorShareTarget.getPluginVersion();
console.log('Plugin version:', version);

Referensi Tipe

ShareReceivedEvent

Data event yang diterima saat konten dibagikan ke aplikasi.

export interface ShareReceivedEvent {
  /**
   * The title of the shared content.
   *
   * @since 0.1.0
   */
  title: string;

  /**
   * Array of text content shared to the application.
   *
   * @since 0.1.0
   */
  texts: string[];

  /**
   * Array of files shared to the application.
   *
   * @since 0.2.0
   */
  files: SharedFile[];
}

SharedFile

Merepresentasikan file yang dibagikan ke aplikasi.

export interface SharedFile {
  /**
   * The URI of the shared file. On Android/iOS this will be a file path or data URL.
   * On web this will be a cached URL accessible via fetch.
   *
   * @since 0.1.0
   */
  uri: string;

  /**
   * The name of the shared file, with or without extension.
   *
   * @since 0.1.0
   */
  name: string;

  /**
   * The MIME type of the shared file.
   *
   * @since 0.1.0
   */
  mimeType: string;
}

Sumber Kebenaran

Halaman ini dibuat dari plugin src/definitions.ts. Jalankan ulang sync saat API publik berubah di upstream.

Lanjutkan dari Getting Started

Jika Anda menggunakan Panduan Memulai untuk merencanakan operasi dashboard dan API, hubungkan dengan Menggunakan @capgo/capacitor-share-target untuk kapabilitas native saat menggunakan @capgo/capacitor-share-target, Ikhtisar API untuk detail implementasi di Ringkasan API, Pendahuluan untuk detail implementasi di Pendahuluan, Kunci API untuk detail implementasi di API Keys, dan Perangkat untuk detail implementasi di Perangkat.