Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
169 changes: 169 additions & 0 deletions src/content/docs/ja/plugin/autostart.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,169 @@
---
title: Autostart(自動起動)
description: システム起動時にアプリを自動的に起動します。
plugin: autostart
i18nReady: true
---

import PluginLinks from '@components/PluginLinks.astro';
import Compatibility from '@components/plugins/Compatibility.astro';

import { Tabs, TabItem, Steps } from '@astrojs/starlight/components';
import CommandTabs from '@components/CommandTabs.astro';
import PluginPermissions from '@components/PluginPermissions.astro';
import TranslationNote from '@components/i18n/TranslationNote.astro';

<TranslationNote lang="ja">

**Plugin 説明内容の英語表記部分について** Plugin 関連の各章は、「Astro Web フレームワーク」により原文データからページ内容の一部が自動生成されているため、英語表記のままの部分があります。

</TranslationNote>

<PluginLinks plugin={frontmatter.plugin} />

システム起動時にアプリを自動的に起動します。

## 対応プラットフォーム

<Compatibility plugin={frontmatter.plugin} />

## セットアップ

はじめに、「Autostart(自動起動)」プラグインをインストールしてください。

<Tabs>
<TabItem label="自動">

自分のプロジェクトのパッケージ・マネージャーを使用して依存関係を追加します:

{' '}

<CommandTabs
npm="npm run tauri add autostart"
yarn="yarn run tauri add autostart"
pnpm="pnpm tauri add autostart"
deno="deno task tauri add autostart"
bun="bun tauri add autostart"
cargo="cargo tauri add autostart"
/>

</TabItem>
<TabItem label="手動">
<Steps>

1. `src-tauri` フォルダで次のコマンドを実行して、`Cargo.toml` 内のプロジェクトの依存関係にこのプラグインを追加します:

```sh frame=none
cargo add tauri-plugin-autostart --target 'cfg(any(target_os = "macos", windows, target_os = "linux"))'
```

2. 追加したプラグインを初期化するために `lib.rs` を修正します:

```rust title="src-tauri/src/lib.rs" ins={5-6}
#[cfg_attr(mobile, tauri::mobile_entry_point)]
pub fn run() {
tauri::Builder::default()
.setup(|app| {
#[cfg(desktop)]
app.handle().plugin(tauri_plugin_autostart::init(tauri_plugin_autostart::MacosLauncher::LaunchAgent, Some(vec!["--flag1", "--flag2"]) /* アプリに渡す任意の数の引数 */));
Ok(())
})
.run(tauri::generate_context!())
.expect("error while running tauri application");
}
```

3. お好みの JavaScript パッケージ・マネージャーを使用して、「JavaScript Guest」バインディングをインストールします:

<CommandTabs
npm="npm install @tauri-apps/plugin-autostart"
yarn="yarn add @tauri-apps/plugin-autostart"
pnpm="pnpm add @tauri-apps/plugin-autostart"
deno="deno add npm:@tauri-apps/plugin-autostart"
bun="bun add @tauri-apps/plugin-autostart"
/>

</Steps>
</TabItem>

</Tabs>

## 使用法

「Autostart(自動起動)」プラグインは、JavaScript と Rust の両方で利用できます。

<Tabs syncKey="lang">
<TabItem label="JavaScript">

```javascript
import { enable, isEnabled, disable } from '@tauri-apps/plugin-autostart';
// `"withGlobalTauri": true` を使用する場合は、
// const { enable, isEnabled, disable } = window.__TAURI__.autostart; を使用できます;

// autostart を有効化
await enable();
// 有効化状態を確認
console.log(`registered for autostart? ${await isEnabled()}`);
// autostart を無効化
disable();
```

</TabItem>
<TabItem label="Rust">

```rust
#[cfg_attr(mobile, tauri::mobile_entry_point)]
pub fn run() {
tauri::Builder::default()
.setup(|app| {
#[cfg(desktop)]
{
use tauri_plugin_autostart::MacosLauncher;
use tauri_plugin_autostart::ManagerExt;

app.handle().plugin(tauri_plugin_autostart::init(
MacosLauncher::LaunchAgent,
Some(vec!["--flag1", "--flag2"]),
));

// 「autostart マネージャー」を入手
let autostart_manager = app.autolaunch();
// autostart を有効化
let _ = autostart_manager.enable();
// 有効化状態を確認
println!("registered for autostart? {}", autostart_manager.is_enabled().unwrap());
// autostart を無効化
let _ = autostart_manager.disable();
}
Ok(())
})
.run(tauri::generate_context!())
.expect("error while running tauri application");
}
```

</TabItem>
</Tabs>

## アクセス権の設定

デフォルトでは、潜在的に危険なプラグイン・コマンドとそのスコープ(有効範囲)はすべてブロックされており、アクセスできません。これらを有効にするには、`capabilities` 設定でアクセス権限を変更する必要があります。

詳細については「[セキュリティ・レベル Capabilities](/ja/security/capabilities/)」の章を参照してください。また、プラグインのアクセス権限を設定するには「[プライグン・アクセス権の使用](/ja/learn/security/using-plugin-permissions/)」の章のステップ・バイ・ステップ・ガイドを参照してください。

```json title="src-tauri/capabilities/default.json"
{
"permissions": [
...,
"autostart:allow-enable",
"autostart:allow-disable",
"autostart:allow-is-enabled"
]
}
```

<PluginPermissions plugin={frontmatter.plugin} />

<div style="text-align: right;">
【※ この日本語版は、「Feb 22, 2025 英語版」に基づいています】
</div>
149 changes: 149 additions & 0 deletions src/content/docs/ja/plugin/barcode-scanner.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,149 @@
---
title: Barcode Scanner(バーコード・スキャナー)
description: モバイル・アプリでカメラを使用し、QR コード、EAN-13、その他のバーコードをスキャン可能にします。
plugin: barcode-scanner
i18nReady: true
---

import PluginLinks from '@components/PluginLinks.astro';
import Compatibility from '@components/plugins/Compatibility.astro';

import { Tabs, TabItem, Steps } from '@astrojs/starlight/components';
import CommandTabs from '@components/CommandTabs.astro';
import PluginPermissions from '@components/PluginPermissions.astro';
import TranslationNote from '@components/i18n/TranslationNote.astro';

<TranslationNote lang="ja">

**Plugin 説明内容の英語表記部分について** Plugin 関連の各章は、「Astro Web フレームワーク」により原文データからページ内容の一部が自動生成されているため、英語表記のままの部分があります。

</TranslationNote>

<PluginLinks plugin={frontmatter.plugin} />

モバイル・アプリでカメラを使用し、QR コード、EAN-13、その他のバーコードをスキャン可能にします。

<TranslationNote lang="ja">

**EAN-13** European Article Number: 商品識別コード/バーコード規格のひとつで、13 桁の「欧州商品番号」の意味。日本で最も普及している商品識別コードである「JAN コード」と同等のもの。《[Wikipedia](https://ja.wikipedia.org/wiki/EANコード)》

</TranslationNote>

## 対応プラットフォーム

<Compatibility plugin={frontmatter.plugin} />

## セットアップ

はじめに、「Barcode Scanner(バーコード・スキャナー)」プラグインをインストールしてください。

<Tabs>
<TabItem label="自動">

自分のプロジェクトのパッケージ・マネージャーを使用して依存関係を追加します:

{' '}

<CommandTabs
npm="npm run tauri add barcode-scanner"
yarn="yarn run tauri add barcode-scanner"
pnpm="pnpm tauri add barcode-scanner"
deno="deno task tauri add barcode-scanner"
bun="bun tauri add barcode-scanner"
cargo="cargo tauri add barcode-scanner"
/>

</TabItem>
<TabItem label="手動">
<Steps>

1. `src-tauri` フォルダで次のコマンドを実行して、`Cargo.toml` 内のプロジェクトの依存関係にこのプラグインを追加します:

```sh frame=none
cargo add tauri-plugin-barcode-scanner --target 'cfg(any(target_os = "android", target_os = "ios"))'
```

2. 追加したプラグインを初期化するために `lib.rs` を修正します:

```rust title="src-tauri/src/lib.rs" ins={5-6}
#[cfg_attr(mobile, tauri::mobile_entry_point)]
pub fn run() {
tauri::Builder::default()
.setup(|app| {
#[cfg(mobile)]
app.handle().plugin(tauri_plugin_barcode_scanner::init());
Ok(())
})
.run(tauri::generate_context!())
.expect("error while running tauri application");
}
```

3. お好みの JavaScript パッケージ・マネージャーを使用して、「JavaScript Guest」バインディングをインストールします:

<CommandTabs
npm="npm install @tauri-apps/plugin-barcode-scanner"
yarn="yarn add @tauri-apps/plugin-barcode-scanner"
pnpm="pnpm add @tauri-apps/plugin-barcode-scanner"
deno="deno add npm:@tauri-apps/plugin-barcode-scanner"
bun="bun add @tauri-apps/plugin-barcode-scanner"
/>

</Steps>

</TabItem>
</Tabs>

## 設定

iOS では、「Barcode Scanner」プラグインに、あなたのアプリがカメラを使用する理由を説明する `NSCameraUsageDescription` 情報プロパティ・リストの値が必要です。

`src-tauri/Info.ios.plist` ファイルには、以下のスニペット(内容)を追加してください。

```xml title=src-tauri/Info.ios.plist
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>NSCameraUsageDescription</key>
<string>Read QR codes</string>
</dict>
</plist>
```

## 使用法

「Barcode Scanner」プラグインは JavaScript で利用できます。

```javascript
import { scan, Format } from '@tauri-apps/plugin-barcode-scanner';
// `"withGlobalTauri": true` を使用する場合は、
// const { scan, Format } = window.__TAURI__.barcodeScanner; を使用できます;

// `windowed: true` は、カメラ用に別のビューを開くのではなく、
// 実際には Webview を透明に設定します
// 要素の透明化により下にあるものが表示されるように、ユーザーインターフェースを設定しておいてください
scan({ windowed: true, formats: [Format.QRCode] });
```

## アクセス権の設定

デフォルトでは、潜在的に危険なプラグイン・コマンドとそのスコープ(有効範囲)はすべてブロックされており、アクセスできません。これらを有効にするには、`capabilities` 設定でアクセス権限を変更する必要があります。

詳細については「[セキュリティ・レベル Capabilities](/ja/security/capabilities/)」の章を参照してください。また、プラグインのアクセス権限を設定するには「[プライグン・アクセス権の使用](/ja/learn/security/using-plugin-permissions/)」の章のステップ・バイ・ステップ・ガイドを参照してください。

```json title="src-tauri/capabilities/mobile.json"
{
"$schema": "../gen/schemas/mobile-schema.json",
"identifier": "mobile-capability",
"windows": ["main"],
"platforms": ["iOS", "android"],
"permissions": ["barcode-scanner:allow-scan", "barcode-scanner:allow-cancel"]
}
```

<PluginPermissions plugin={frontmatter.plugin} />

<div style="text-align: right;">
【※ この日本語版は、「Jul 1, 2025 英語版」に基づいています】
</div>
Loading