Merge pull request #4089 from yamatoya/master

Add  Japanese translated docs.
This commit is contained in:
Cheng Zhao 2016-01-14 09:48:18 +08:00
Родитель 9bfc8c9bd0 b373fbc552
Коммит 463bc8738a
3 изменённых файлов: 538 добавлений и 0 удалений

Просмотреть файл

@ -0,0 +1,43 @@
# Accelerator
acceleratorは、キーボードショートカットを示す文字列です。複数の修飾語句とキーコードを `+` 文字で結合します。
例:
* `Command+A`
* `Ctrl+Shift+Z`
## プラットフォームの留意点
OS Xでは`Command` キー、LinuxとWindowsでは`Control` キーを意味する`CommandOrControl`はいくつかのacceleratorを定義しますが、LinuxとWindowsでは、`Command` キーは何の効果もありません。
`Super` キーは、WindowsとLinuxでは `Windows` キーに、OS Xでは、`Cmd` キーに関連付けられます。
## 提供されている修飾語句
* `Command` (または、短く `Cmd`)
* `Control` (または、短く `Ctrl`)
* `CommandOrControl` (または、短く `CmdOrCtrl`)
* `Alt`
* `Shift`
* `Super`
## 提供されているキーコード
* `0` to `9`
* `A` to `Z`
* `F1` to `F24`
* `~`, `!`, `@`, `#`, `$`などの記号
* `Plus`
* `Space`
* `Backspace`
* `Delete`
* `Insert`
* `Return` (またはエイリアスで `Enter`)
* `Up``Down`,`Left`、 `Right`
* `Home``End`
* `PageUp``PageDown`
* `Escape` (または、短く `Esc`)
* `VolumeUp``VolumeDown``VolumeMute`
* `MediaNextTrack``MediaPreviousTrack``MediaStop``MediaPlayPause`

Просмотреть файл

@ -0,0 +1,410 @@
# app
`app` モジュールは、アプリケーションのライフサイクルコントロールを担います。
次の例は、最後のウィンドウが閉じたときにアプリケーションを終了させる方法を示しています。
```javascript
const app = require('electron').app;
app.on('window-all-closed', function() {
app.quit();
});
```
## イベント
`app` オブジェクトは次のイベントを出力します。
### イベント: 'will-finish-launching'
アプリケーションの基礎起動が終わったときに出力されます。Windows と Linuxでは、 `will-finish-launching` イベントと`ready`イベントは同じです。OS Xでは、`NSApplication`の `applicationWillFinishLaunching` 通知をに相当します。通常、`open-file`と`open-url` 用のリスナーの設定、クラッシュレポートの開始、自動アップデートをします。
ほとんどの場合、 `ready` イベントハンドラーですべてをするべきです。
### イベント: 'ready'
Electronの初期化が終わった時に出力します。
### イベント: 'window-all-closed'
全てのウィンドウを閉じたときに出力します。
このイベントは、アプリケーションが終了する予定ではないときのみ出力します。ユーザーが `Cmd + Q`を押したり、開発者が`app.quit()`をコールすると、Electronは最初にすべてのウィンドウをクローズしようとし、`will-quit`イベントを出力します。この場合、`window-all-closed`イベントは出力されません。
### イベント: 'before-quit'
戻り値:
* `event` Event
アプリケーションがウィンドウをクローズし始める前に出力します。`event.preventDefault()`をコールすると、アプリケーションを終了させる既定の挙動を止めることができます。
### イベント: 'will-quit'
戻り値:
* `event` Event
全てのウィンドウが閉じて、アプリケーションを終了するときに出力します。`event.preventDefault()`をコールすると、アプリケーションを終了させる既定の挙動を止めることができます。
詳細は、`will-quit`イベント と `window-all-closed` イベントの違いは、`window-all-closed` イベントの説明を見てください。
### イベント: 'quit'
戻り値:
* `event` Event
* `exitCode` Integer
アプリケーションが終了したときに出力されます。
### イベント: 'open-file' _OS X_
戻り値:
* `event` Event
* `path` String
アプリケーションでファイルを開こうとしたときに出力します。アプリケーションがすでに起動し、OSがファイルを開くアプリケーションを再使用したいとき、`open-file`イベントは出力します。ファイルがdockにドロップアウトされ、アプリケーションがまだ起動していないときにも`open-file` は出力します。このケースを処理するために、アプリケーションの起動のかなり早い段階で、`open-file` イベントをリッスンして確認します(まだ `ready` イベントが出力する前に)。
このイベントをハンドルしたいときには `event.preventDefault()` をコールすべきです。
Windowsでは、ファイルパスを取得するために、 `process.argv` をパースする必要があります。
### イベント: 'open-url' _OS X_
戻り値:
* `event` Event
* `url` String
アプリケーションでURLを開こうとしたときに出力されます。URLスキーマーは、アプリケーションが開くように登録しなければなりません。
このイベントをハンドルしたい場合は、`event.preventDefault()`をコールすべきです。
### イベント: 'activate' _OS X_
戻り値:
* `event` Event
* `hasVisibleWindows` Boolean
アプリケーションがアクティブになったときに出力されます。通常は、アプリケーションのドックアイコンをクリックしたときに発生します。
### イベント: 'browser-window-blur'
戻り値:
* `event` Event
* `window` BrowserWindow
[browserWindow](browser-window.md) からフォーカスが外れたときに出力されます。
### イベント: 'browser-window-focus'
戻り値:
* `event` Event
* `window` BrowserWindow
[browserWindow](browser-window.md) にフォーカスが当たったとき出力されます。
### イベント: 'browser-window-created'
戻り値:
* `event` Event
* `window` BrowserWindow
新しい [browserWindow](browser-window.md) が作成されたときに出力されます。
### イベント: 'certificate-error'
戻り値:
* `event` Event
* `webContents` [WebContents](web-contents.md)
* `url` URL
* `error` String - The error code
* `certificate` Object
* `data` Buffer - PEM encoded data
* `issuerName` String
* `callback` Function
`url``certificate` 検証に失敗したときに発生します。証明書を信頼するために`event.preventDefault()` と `callback(true)`をコールして既定の動作を止める必要があります。
```javascript
session.on('certificate-error', function(event, webContents, url, error, certificate, callback) {
if (url == "https://github.com") {
// Verification logic.
event.preventDefault();
callback(true);
} else {
callback(false);
}
});
```
### イベント: 'select-client-certificate'
戻り値:
* `event` Event
* `webContents` [WebContents](web-contents.md)
* `url` URL
* `certificateList` [Objects]
* `data` Buffer - PEM encoded data
* `issuerName` String - Issuer's Common Name
* `callback` Function
クライアント証明書が要求されたときに出力されます。
`url` は、クライアント証明書を要求するナビゲーションエントリーに対応し、`callback` リストからエントリをフィルターしてコールするのに必要です。`event.preventDefault()` を使用して、アプリケーションの証明書ストアから最初の証明書を使用するのを止めることができます。
```javascript
app.on('select-client-certificate', function(event, webContents, url, list, callback) {
event.preventDefault();
callback(list[0]);
})
```
### イベント: 'login'
Returns:
* `event` Event
* `webContents` [WebContents](web-contents.md)
* `request` Object
* `method` String
* `url` URL
* `referrer` URL
* `authInfo` Object
* `isProxy` Boolean
* `scheme` String
* `host` String
* `port` Integer
* `realm` String
* `callback` Function
`webContents` がベーシック認証をしようとしたときに出力されます。
既定の動作ではすべての認証をキャンセルしたり、`event.preventDefault()` と `callback(username, password)` とを証明書でコールし既定の動作をとめてオーバーライドします。
```javascript
app.on('login', function(event, webContents, request, authInfo, callback) {
event.preventDefault();
callback('username', 'secret');
})
```
### イベント: 'gpu-process-crashed'
gpu プロセスがクラッシュしたときに出力されます。
## メソッド
`app` オブジェクトは次のメソッドを持ちます。
**Note:** いくつかのメソッドは、特定のオペレーティングシステム向けに提供され、そのようにラベルで表示します。
### `app.quit()`
全てのウィンドウを閉じようとします。`before-quit`イベントは、最初に出力されます。すべてのウィンドウを閉じることに成功したら、`will-quit`イベントが出力され、既定では、アプリケーションが終了します。
このメソッドは、全ての`beforeunload`と`unload`イベントハンドラは正確に発生することを保証されます。`beforeunload` イベントハンドラで、`false`を返すことでウィンドウの終了をキャンセルすることができます。
### `app.exit(exitCode)`
* `exitCode` Integer
`exitCode`で今すぐ終了します。
全てのウィンドウは、ユーザーに確認することなく、すぐに閉じ、`before-quit`と`will-quit` イベントは出力されません。
### `app.getAppPath()`
減殺のアプリケーションディレクトリを戻します。
### `app.getPath(name)`
* `name` String
`name`に関連した特定のディレクトリやファイルへのパスを返します。失敗したら、`Error`をスローします。
`name`で次のパスをリクエストできます。
* `home` ユーザーのホームディレクトリ
* `appData` 既定で示すユーザーごとのアプリケーションディレクトリ
* `%APPDATA%` Windows上
* `$XDG_CONFIG_HOME` or `~/.config` Linux上
* `~/Library/Application Support` OS X上
* `userData` アプリの設定ファイルを格納するディレクトリで、既定では`appData` ディレクトリ配下のアプリ名ディレクトリです
* `temp` 一時ディレクトリ
* `exe` 現在の実行ファイル
* `module` `libchromiumcontent` ライブラリ
* `desktop` 現在のユーザーのデスクトップディレクトリ
* `documents` ユーザーの "My Documents"用ディレクトリ
* `downloads` ユーザーのダウンロード用ディレクトリ
* `music` ユーザーのミュージック用ディレクトリ
* `pictures` ユーザーのピクチャー用ディレクトリ
* `videos` ユーザーのビデオ用ディレクトリ
### `app.setPath(name, path)`
* `name` String
* `path` String
`name`に関連した特定のディレクトリやファイルへの`path` を上書きします。存在しないパスを指定した場合、このメソッドがディレクトリを作成します。失敗したら、`Error`をスローします。
`app.getPath`で、`name` で定義されたパスを上書きできます。
既定では、webページのクッキーとキャッシュは`userData`ディレクトリ配下に格納できます。ロケーションを変更したい場合、 `app` モジュールの `ready` イベントが出力される前に`userData`パスを上書きする必要があります。
### `app.getVersion()`
ロードしたアプリケーションのバージョンを戻します。アプリケーションの `package.json`ファイルにversionが無ければ、現在のバンドルまたは実行ファイルのバージョンになります。
### `app.getName()`
現在のアプリケーション名を戻し、`package.json` ファイルのnameです。
通常、 `package.json`の`name` フィールドは、短い小文字名で、npm module spec と一致します。通常、`productName`で、アプリケーションの大文字正式名を指定し、Electronでは`name`をそれで上書きます。
### `app.getLocale()`
現在のアプリケーションのロケールを戻します。
### `app.addRecentDocument(path)` _OS X_ _Windows_
* `path` String
最近のドキュメント一覧に`path`を追加します。
この一覧はOSが管理しています。Windowsではタスクバーからこの一覧を見れ、OS Xではdockメニューから見れます。
### `app.clearRecentDocuments()` _OS X_ _Windows_
最近のドキュメント一覧をクリアします。
### `app.setUserTasks(tasks)` _Windows_
* `tasks` Array - `Task` オブジェクトの配列
Windowsのジャンプリストの[Tasks][tasks]カテゴリに`tasks`を追加します。
`tasks` は`Task`オブジェクトの配列で、次のフォーマットになります。
`Task` Object:
* `program` String - 実行するプログラムのパスで、通常はプログラムが開く`process.execPath`を指定します
* `arguments` String - `program` を実行するときのコマンドライン引数です
* `title` String - ジャンプリストに表示される文字列です
* `description` String - タスクの説明
* `iconPath` String - ジャンプリストに表示するアイコンの絶対パスで、アイコンを含む任意のリソースファイルです。通常、プログラムのアイコンを表示する`process.execPath`を指定します。
* `iconIndex` Integer - アイコンファイルのアイコンインデックスです。アイコンファイルに2つ以上のアイコンが含まれている場合、この値でアイコンを指定します。1つしかアイコンファイルに含まれていない場合は、この値は0です。
### `app.allowNTLMCredentialsForAllDomains(allow)`
* `allow` Boolean
HTTP NTLMまたはNegotiate認証用の照明を常に送信するかどうかを動的に設定できます。通常、Electronはローカルインターネットサイト例えば、あなたと同じドメイン名のときに該当するURL用のNTLM/Kerberos証明書のみ送信します。しかし、この検知はコーポレートネットワークの設定が悪いときには、頻繁に失敗するので、この挙動を共通に行うことを選べば、全てのURLで有効にできます。
### `app.makeSingleInstance(callback)`
* `callback` Function
このメソッドは、アプリケーションをシングルインスタンスアプリケーションにします。アプリの実行を複数のインスタンスで実行することを許可せず、アプリケーション実行をシングルインスタンスのみにすることを保証し、ほかのインスタンスにはこのインスタンスの存在を知らせ終了さえます。
2つ目のインスタンスが起動したとき、`callback` は、`callback(argv, workingDirectory)` でコールします。`argv` は、2つ目のインスタンスのコマンドライン引数の配列で、`workingDirectory` は現在のワーキングディレクトリです。通常、アプリケーションはメインのウィンドウにフォーカスをあて最小化させないことで対応します。
The `callback` は、 `app`の`ready` イベントの出力後に実行することを保証します。
プロセスがアプリケーションのプライマリインスタンスでアプリがロードし続けるなら、このメソッドは `false`を戻します。プロセスがほかのインスタンスにパラメーターを送信し、`true`を戻すと、直ちに終了します。
OS Xは、ユーザーがFinderで2つ目のアプリインスタンスを開いたり、`open-file` 、 `open-url`イベントが出力しようとすると、システムが自動的にシングルインスタンスを強制します。しかし、コマンドラインでアプリを開始するとシステムのシングルインスタンスメカニズムは無視されるので、シングルインスタンスを強制するためには、このメソッドを使う必要があります。
2つ目のインスタンスを起動するとき、メインのインスタンスのウィンドウをアクティブにする例
```js
var myWindow = null;
var shouldQuit = app.makeSingleInstance(function(commandLine, workingDirectory) {
// Someone tried to run a second instance, we should focus our window
if (myWindow) {
if (myWindow.isMinimized()) myWindow.restore();
myWindow.focus();
}
return true;
});
if (shouldQuit) {
app.quit();
return;
}
// Create myWindow, load the rest of the app, etc...
app.on('ready', function() {
});
```
### `app.setAppUserModelId(id)` _Windows_
* `id` String
[Application User Model ID][app-user-model-id] を `id`に変更します。
### `app.commandLine.appendSwitch(switch[, value])`
Chromiumのコマンドラインにスイッチ `value`をオプションにし)を追加します。
**Note:** これは、`process.argv`に影響せず、開発者が、Chromiumのローレベルな挙動をコントロールするのに使用します。
### `app.commandLine.appendArgument(value)`
Chromiumのコマンドダインに引数を追加します。引数は正しく引用符で囲まれます。
**Note:** `process.argv`に影響しません。
### `app.dock.bounce([type])` _OS X_
* `type` String (optional) - `critical` または `informational`を指定できます。既定では、 `informational`です。
`critical`を渡すと、アプリケーションがアクティブ、もしくはリクエストがキャンセルされるまでは、dockアイコンは、バウンスします。
`informational` を渡すと、1秒dockアイコンはバウンスします。しかし、アプリケーションがアクティブ、もしくはリクエストがキャンセルされるまでは、リクエストは残ります。
リクエストを示すIDを戻します。
### `app.dock.cancelBounce(id)` _OS X_
* `id` Integer
`id`のバウンスをキャンセルします。
### `app.dock.setBadge(text)` _OS X_
* `text` String
dockのバッジエリアで表示する文字列を設定します。
### `app.dock.getBadge()` _OS X_
dockのバッジ文字列を戻します。
### `app.dock.hide()` _OS X_
dock アイコンを隠します。
### `app.dock.show()` _OS X_
dock アイコンを表示します。
### `app.dock.setMenu(menu)` _OS X_
* `menu` Menu
アプリケーションの[dock menu][dock-menu]を設定します。
[dock-menu]:https://developer.apple.com/library/mac/documentation/Carbon/Conceptual/customizing_docktile/concepts/dockconcepts.html#//apple_ref/doc/uid/TP30000986-CH2-TPXREF103
[tasks]:http://msdn.microsoft.com/en-us/library/windows/desktop/dd378460(v=vs.85).aspx#tasks
[app-user-model-id]: https://msdn.microsoft.com/en-us/library/windows/desktop/dd378459(v=vs.85).aspx

Просмотреть файл

@ -0,0 +1,85 @@
# autoUpdater
このモジュールは、`Squirrel`オートアップデートフレームワークのインターフェイスを提供します。
## プラットフォーム留意点
`autoUpdater`は、異なるプラットフォーム用に統一したAPIを提供していますが、それぞれのプラットフォーム上で、まだ多少の差があります。
### OS X
OS Xでは、 `autoUpdater` モジュールは、[Squirrel.Mac][squirrel-mac]上に構築されていて、動作させるのに特別な設定が不要であることを意味します。サーバーサイドの要件は、[Server Support][server-support]を読んでください。
### Windows
Windowsでは、auto-updaterを使う前に、ユーザーのPCにアプリをインストールする必要があるので、Windows インストーラーを生成するために[grunt-electron-installer][installer]モジュールを使用することをお勧めします。
Squirrelで生成されたインストーラーは、`com.squirrel.PACKAGE_ID.YOUR_EXE_WITHOUT_DOT_EXE`のフォーマット(例えば、`com.squirrel.slack.Slack` と `com.squirrel.code.Code`)で[Application User Model ID][app-user-model-id]とショートカットアイコンを作成します。`app.setAppUserModelId`APIで同じIDを使う必要があります。同じIDでないと、Windowsはタスクバーに適切にピン止めすることができません。
サーバーサイドのセットアップは、OS Xと異なります。詳細は、[Squirrel.Windows][squirrel-windows] を参照してください。
### Linux
Linuxでは、auot-updater用のサポートがビルトインされていないので、アプリをアップデートするためにディストリビューションのパッケージマネジャーを使用することをお勧めします。
## イベント
`autoUpdater` オブジェクトは次のイベントを出力します。
### イベント: 'error'
戻り値:
* `error` Error
アップデート中にエラーがあった場合に出力されます。
### イベント: 'checking-for-update'
アップデートを開始したかチェックしたときに出力されます。
### イベント: 'update-available'
アップデートが提供されているときに出力されます。アップデートは自動的にダウンロードされます。
### イベント: 'update-not-available'
アップデートが提供されていないときに出力されます。
### イベント: 'update-downloaded'
戻り値:
* `event` Event
* `releaseNotes` String
* `releaseName` String
* `releaseDate` Date
* `updateURL` String
アップデートをダウンロードしたときに出力されます。
Windowsでは、`releaseName` のみ提供されます。
## メソッド
`autoUpdater` オブジェクトは次のメソッドを持っています。
### `autoUpdater.setFeedURL(url)`
* `url` String
`url`を設定し、自動アップデートを初期化します。 `url`は一度設定すると変更できません。
### `autoUpdater.checkForUpdates()`
アップデートがあるかどうかサーバーに問い合わせます。APIを使う前に、`setFeedURL`をコールしなければなりません。
### `autoUpdater.quitAndInstall()`
ダウンロード後、アプリを再起動して、アップデートをインストールします。`update-downloaded`が出力された後のみ、コールすべきです。
[squirrel-mac]: https://github.com/Squirrel/Squirrel.Mac
[server-support]: https://github.com/Squirrel/Squirrel.Mac#server-support
[squirrel-windows]: https://github.com/Squirrel/Squirrel.Windows
[installer]: https://github.com/atom/grunt-electron-installer
[app-user-model-id]: https://msdn.microsoft.com/en-us/library/windows/desktop/dd378459(v=vs.85).aspx