app | Electron メインコンテンツへ飛ぶ Electron ドキュメント API ブログ ツール * Electron Forge * Electron Fiddle コミュニティ * ガバナンス * 事例紹介 * リソース リリース 日本語 * English * Deutsch * Español * Français * 日本語 * Português * Русский * 中文 検索 * メインプロセスモジュール * app * autoUpdater * BaseWindow * BrowserView * Deprecated * BrowserWindow * clipboard * contentTracing * crashReporter * desktopCapturer * dialog * globalShortcut * ImageView * inAppPurchase * ipcMain * Menu * MenuItem * MessageChannelMain * MessagePortMain * nativeImage * nativeTheme * net * netLog * Notification * powerMonitor * powerSaveBlocker * process * protocol * pushNotifications * safeStorage * screen * session * sharedTexture * ShareMenu * shell * systemPreferences * TouchBar * Tray * utilityProcess * webContents * WebContentsView * webFrameMain * 表示 * レンダラープロセスモジュール * Utility Process Modules * カスタム DOM 要素 * Chromium と Node.js * クラス * API の構造体 * * メインプロセスモジュール * app 目次 app アプリケーションのイベントライフサイクルを制御します。 プロセス: メイン 以下の例では最後のウインドウが閉じられたときにアプリケーションを終了する方法を示します。 const { app } = require ( 'electron' ) app . on ( 'window-all-closed' , ( ) => { app . quit ( ) } ) イベント ​ app オブジェクトでは以下のイベントが発生します。 イベント: 'will-finish-launching' ​ アプリケーションが基本的な起動処理を完了したときに発生します。 Windows と Linux上では、 will-finish-launching イベントは ready イベントと同じです。macOS上では、このイベントは NSApplication の applicationWillFinishLaunching 通知を表しています。 ほとんどの場合、 ready イベントハンドラーですべてのことを行うようにするべきです。 イベント: 'ready' ​ 戻り値: * event Event * launchInfo Record<string, any> | NotificationResponse macOS Electron が一度、初期化処理を完了したときに発生します。 macOS でアプリケーションが通知センターから起動された場合、 launchInfo はアプリケーションを開くために使用された NSUserNotification の userInfo や UNNotificationResponse の情報を保持しています。 また、 app.isReady() を呼び出してこのイベントが発生したことがあるかどうかを確認したり、 app.whenReady() を呼び出して Electron 初期化時に解決される Promise を取得したりできます。 note ready イベントは、メインプロセスがイベントループの最初のティックを完了した後にのみ発生します。 ready イベントの前に Electron API を呼び出す必要がある場合は、メインプロセスのトップレベルのコンテキストで同期呼び出しをしてください。 イベント: 'window-all-closed' ​ すべてのウィンドウが閉じられたときに発生します。 このイベントを購読せずに全てのウインドウを閉じた場合、既定の動作としてアプリは終了します。しかし、このイベントを購読している場合は、アプリを終了するかどうかを制御することができます。 ユーザが Cmd + Q を押下したり、開発者が app.quit() を呼び出したりした場合では、Electron はまず全てのウインドウを閉じようとして、その後に will-quit イベントを発生させます。しかし、この場合は window-all-closed イベントは発生しません。 イベント: 'before-quit' ​ 戻り値: * event Event アプリケーションがウィンドウを閉じ始める前に発生します。 event.preventDefault() を呼び出すことで、アプリケーションが終了する既定の動作を阻害できます。 [!NOTE] アプリケーションの終了が autoUpdater.quitAndInstall() によって開始された場合、全てのウインドウで close イベントを発生させ、それらが閉じた 後 に before-quit が発生します。 [!NOTE] Windows では、このイベントはシステムのシャットダウン/再起動やユーザーのログアウトでアプリケーションが閉じられようとしている場合には発生しません。 イベント: 'will-quit' ​ 戻り値: * event Event すべてのウィンドウが閉じられ、アプリが終了しようとしているときに発生します。 event.preventDefault() を呼び出すことで、アプリケーションが終了する既定の動作を阻害できます。 will-quit と window-all-closed イベントの差異を確認するためには、 window-all-closed イベントの説明もお読みください。 [!NOTE] Windows では、このイベントはシステムのシャットダウン/再起動やユーザーのログアウトでアプリケーションが閉じられようとしている場合には発生しません。 イベント: 'quit' ​ 戻り値: * event Event * exitCode Integer アプリケーションが終了するときに発生します。 [!NOTE] Windows では、このイベントはシステムのシャットダウン/再起動やユーザーのログアウトでアプリケーションが閉じられようとしている場合には発生しません。 イベント: 'open-file' macOS ​ 戻り値: * event Event * path string ユーザがアプリケーションでファイルを開こうとしたときに発生します。 open-file イベントは、大抵の場合ファイルをアプリケーションが既に開いていて、OS が開くために再利用しようとしたときに発生します。 open-file は、Dock にファイルがドロップされて、アプリケーションがまだ起動していないときにも発生します。 このようなケースに対処するために、アプリケーション起動時の非常に早い段階 ( ready イベントが発生するよりも前) で open-file イベントを監視するようにしてください。 このイベントを処理する場合、 event.preventDefault() を呼び出す必要があります。 Windows では、ファイルパスを取得するために (メインプロセスの) process.argv をパースしなければなりません。 イベント: 'open-url' macOS ​ 戻り値: * event Event * url string ユーザがこのアプリケーションで URL を開こうとしたときに発生します。 アプリケーションの Info.plist ファイルで CFBundleURLTypes キーの中に URL スキームを定義し、 NSPrincipalClass に AtomApplication を設定しなければなりません。 open-file イベントと同様に、アプリケーションの起動時に open-url イベントのリスナーを必ず登録し、アプリケーションが URL のハンドリングとして開かれているかどうかを検出するようにしてください。 ready イベントの応答でリスナーを登録すると、アプリケーション起動のトリガーとなった URL を逃すことになります。 イベント: 'activate' macOS ​ 戻り値: * event Event * hasVisibleWindows boolean アプリケーションがアクティブになったときに発生します。 アプリケーションが最初に起動される、既に実行中のときにアプリケーションを再起動しようとする、アプリケーションのドックやタスクバーのアイコンをクリックするなど、いろいろなアクションがこのイベントの引き金となり得ます。 イベント: 'did-become-active' macOS ​ 戻り値: * event Event アプリケーションがアクティブになったときに発生します。 did-become-active は activate イベントと異なり、アプリがアクティブになるときだけでなく、Dock アイコンがクリックされた時やアプリケーションが再起動した時にも発生します。 また、ユーザーが macOS のアプリ切り替えでこのアプリへと切り替えたときにも発生します。 イベント: 'did-resign-active' macOS ​ 戻り値: * event Event アプリがアクティブでなくなり、フォーカスがなくなったときに発生します。 これは例えば、他のアプリケーションをクリックしたり、macOS のアプリ切り替えで他のアプリケーションへ切り替えたりすると発生します。 イベント: 'continue-activity' macOS ​ 戻り値: * event Event * type string - アクティビティを識別する文字列。 Maps to NSUserActivity.activityType . * userInfo unknown - 別のデバイスのアクティビティによって保存されたアプリ固有の情報が含まれています。 * details Object * webpageURL string (任意) - 利用可能な場合、別デバイス上の操作でアクセスしたウェブページの URL を特定する文字列になります。 Handoff 中、別のデバイスでアクティビティが再開されようとする際に発生します。 このイベントを処理する場合、 event.preventDefault() を呼び出す必要があります。 ユーザのアクティビティはアクティビティ元のアプリと同一の開発者チームIDを持ち、アクティビティタイプをサポートするアプリでしか継続させることができません。 サポートされるアクティビティタイプは、アプリの Info.plist の NSUserActivityTypes キーで指定されています。 イベント: 'will-continue-activity' macOS ​ 戻り値: * event Event * type string - アクティビティを識別する文字列。 Maps to NSUserActivity.activityType . Handoff 中に、異なるデバイスでアクティビティが再開される前に発生します。 このイベントを処理する場合、 event.preventDefault() を呼び出す必要があります。 イベント: 'continue-activity-error' macOS ​ 戻り値: * event Event * type string - アクティビティを識別する文字列。 Maps to NSUserActivity.activityType . * error string - エラーのローカライズされた説明としての文字列。 Handoff 中に、異なるデバイスでアクティビティの再開に失敗したときに発生します。 イベント: 'activity-was-continued' macOS ​ 戻り値: * event Event * type string - アクティビティを識別する文字列。 Maps to NSUserActivity.activityType . * userInfo unknown - アクティビティによって保存されたアプリ固有の情報が含まれています。 Handoff 中、別のデバイスでアクティビティが正常に再開された後に発生します。 イベント: 'update-activity-state' macOS ​ 戻り値: * event Event * type string - アクティビティを識別する文字列。 Maps to NSUserActivity.activityType . * userInfo unknown - アクティビティによって保存されたアプリ固有の情報が含まれています。 Handoff が別のデバイスで再開される直前に発生します。 送信される情報を更新する必要があれば、 event.preventDefault() をすぐに呼び出してください。そして、新しい userInfo 辞書を構築して app.updateCurrentActivity() を適切に呼び出してください。 さもなくば操作は失敗し、 continue-activity-error が呼び出されます。 イベント: 'new-window-for-tab' macOS ​ 戻り値: * event Event ユーザーが macOS ネイティブの新規タブボタンをクリックすると発生します。 The new tab button is only visible if the current BrowserWindow has a tabbingIdentifier . You must create a window in this handler in order for macOS tabbing to work as expected. イベント: 'browser-window-blur' ​ 戻り値: * event Event * window BrowserWindow browserWindow のフォーカスが外れたときに発生します。 イベント: 'browser-window-focus' ​ 戻り値: * event Event * window BrowserWindow browserWindow がフォーカスされたときに発生します。 イベント: 'browser-window-created' ​ 戻り値: * event Event * window BrowserWindow 新しく browserWinodow が生成されたときに発生します。 イベント: 'web-contents-created' ​ 戻り値: * event Event * webContents WebContents 新しく webContents が作成されたときに発生します。 イベント: 'certificate-error' ​ 戻り値: * event Event * webContents WebContents * url string * error string - エラーコード * certificate Certificate * callback Function * isTrusted boolean - 証明書を信頼できるものと見なすかどうか * isMainFrame boolean url に対する certificate の検証に失敗したときに発生します。証明書を信頼するためには、 event.preventDefault() で既定の動作をキャンセルして、 callback(true) を呼び出すようにしてください。 const { app } = require ( 'electron' ) app . on ( 'certificate-error' , ( event , webContents , url , error , certificate , callback ) => { if ( url === 'https://github.com' ) { // 検証ロジック。 event . preventDefault ( ) callback ( true ) } else { callback ( false ) } } ) イベント: 'select-client-certificate' ​ 戻り値: * event Event * webContents WebContents * url URL * certificateList Certificate[] * callback Function * certificate Certificate (任意) クライアント証明書が要求されたときに発生します。 url がクライアント証明書を要求しているナビゲーションエントリーに対応していれば、リストからフィルターされたエントリーで callback を呼び出すことができます。 event.preventDefault() を使うことで、アプリケーションがストアから最初の証明書を使うのをキャンセルできます。 const { app } = require ( 'electron' ) app . on ( 'select-client-certificate' , ( event , webContents , url , list , callback ) => { event . preventDefault ( ) callback ( list [ 0 ] ) } ) イベント: 'login' ​ 戻り値: * event Event * webContents WebContents (任意) * authenticationResponseDetails Object * url URL * pid number * isRequestForNavigation boolean - Indicates whether the request is for a navigation. * firstAuthAttempt boolean - Indicates whether this is the first authentication attempt. * responseHeaders Record<string, string | string[]> (optional) - The headers returned in the response. * authInfo Object * isProxy boolean * scheme string * host string * port Integer * realm string * callback Function * username string (任意) * password string (optional) webContents または ユーテリティプロセス が Basic 認証を要求すると発生します。 既定の動作では、全てに認証をキャンセルします。 これを変更するには、 event.preventDefault() で既定の動作をキャンセルして、資格情報と共に callback(username, password) を呼び出すようにしてください。 const { app } = require ( 'electron' ) app . on ( 'login' , ( event , webContents , details , authInfo , callback ) => { event . preventDefault ( ) callback ( 'username' , 'secret' ) } ) ユーザー名またはパスワードを渡さずに callback を呼び出すと、認証リクエストはキャンセルされ、認証エラーがページに返されます。 イベント: 'gpu-info-update' ​ GPU 情報の更新がある場合に発生します。 イベント: 'render-process-gone' ​ 戻り値: * event Event * webContents WebContents * details RenderProcessGoneDetails renderer processが予期せず消えたときに発生します。 プロセスがクラッシュした場合やキルされた場合は正常です。 イベント: 'child-process-gone' ​ 戻り値: * event Event * details Object * type string - プロセスの種別。 以下の値のいずれかです。 * Utility * Zygote * Sandbox helper * GPU * Pepper Plugin * Pepper Plugin Broker * Unknown * reason string - 子プロセスがなくなった理由。 取りうる値: * clean-exit - ゼロの終了コードでプロセスが終了した * abnormal-exit - 非ゼロの終了コードでプロセスが終了した * killed - プロセスが SIGTERM シグナルの送信などの方法でキルされた * crashed - プロセスがクラッシュした * oom - プロセスがメモリ不足になった * launch-failed - プロセスが正常に起動されなかった * integrity-failure - Windows コードの整合性チェックに失敗した * memory-eviction - 将来のメモリ不足（OOM）を防ぐため、事前にプロセスを終了した * exitCode number - プロセスの終了コード。（例: posix では waitpid から、Windows では GetExitCodeProcess からのステータス） * serviceName string (任意) - そのプロセスのローカライズされていない名前。 * name string (任意) - そのプロセスの名前。 ユーティリティの例: Audio Service , Content Decryption Module Service , Network Service , Video Capture など 子 processが予期せず消えたときに発生します。 プロセスがクラッシュした場合やキルされた場合は正常です。 レンダラープロセスを含みません。 イベント: 'accessibility-support-changed' macOS Windows ​ 戻り値: * event Event * accessibilitySupportEnabled boolean - true when Chromium's accessibility support is enabled, false otherwise. Emitted when Chromium's accessibility support changes. このイベントはスクリーンリーダーのような支援技術が有効にされたり、無効にされたりしたときに発火します。 詳細については、 https://www.chromium.org/developers/design-documents/accessibility を参照してください。 イベント: 'session-created' ​ 戻り値: * session Session Electron が新しい session を作成したときに発生します。 const { app } = require ( 'electron' ) app . on ( 'session-created' , ( session ) => { console . log ( session ) } ) イベント: 'second-instance' ​ 戻り値: * event Event * argv string[] - 2 つ目のインスタンスのコマンドライン引数の配列 * workingDirectory string - 2 つ目のインスタンスの作業ディレクトリ * additionalData unknown - 2 つ目のインスタンスから渡される追加データの JSON オブジェクト このイベントは、2 つ目のインスタンスが実行され app.requestSingleInstanceLock() が実行されたとき、アプリケーションの1つ目のインスタンス内で発火されます。 argv は2番目のインスタンスのコマンドライン引数の配列で、 workingDirectory はその現在の作業ディレクトリです。 通常、アプリケーションはこれに対して1番目のウインドウにフォーカスを当て、最小化しないように対応します。 note argv は 2 番目のインスタンスに渡されたものと全く同じ引数リストになるとは限りません。 順番が変わったり、追加の引数が付け加えられたりする可能性があります。 全く同じ引数を保持する必要がある場合は、代わりに additionalData の使用を推奨します。 [!NOTE] 2 番目のインスタンスを最初のインスタンスと別のユーザーが起動した場合、 argv 配列には引数が含まれません。 このイベントは app の ready イベントが発生した後で実行されることが保証されます。 [!NOTE] Chromium が --original-process-start-time などのコマンドライン引数を追加することがあります。 メソッド ​ app オブジェクトには以下のメソッドがあります。 [!NOTE] いくつかのメソッドは特定のオペレーティングシステムでのみ利用可能で、そのように注記がつけられています。 app.quit() ​ すべてのウインドウを閉じようとします。 before-quit イベントが最初に発生します。 すべてのウインドウを閉じることに成功した場合、 will-quit イベントが発生し、既定ではアプリケーションは終了します。 このメソッドは、すべての beforeunload および unload イベントハンドラーが正しく実行されることを保証します。 beforeunload イベントハンドラーで false を返すことによって、ウインドウが終了処理をキャンセルすることができます。 app.exit([exitCode]) ​ * exitCode Integer (optional) exitCode ですぐに終了します。 exitCode の省略値は 0 です。 ユーザに確認することなくすべてのウインドウがすぐに閉じられ、 before-quit および will-quit イベントは発生しません。 app.relaunch([options]) ​ * options Object (任意) * args string[] (任意) * execPath string (任意) 現在のインスタンスが終了したときに、アプリを再起動します。 デフォルトでは、新しいインスタンスも現在と同じカレントディレクトリとコマンドライン引数を使用します。 args が指定されている場合、 args がコマンドライン引数の代わりに渡されます。 execPath が指定されている場合、再起動として現在のアプリの代わりに execPath が実行されます。 このメソッドは実行時にはアプリを再起動しないことに注意してください。 アプリを再起動するには app.relaunch を呼んだ後、 app.quit か app.exit を実行する必要があります。 app.relaunch が複数回呼び出された場合、現在のインスタンスが終了した後、複数のインスタンスが開始されます。 現在のインスタンスをすぐに終了し、新しいコマンドライン引数を追加して再起動する例は以下の通りです。 const { app } = require ( 'electron' ) app . relaunch ( { args : process . argv . slice ( 1 ) . concat ( [ '--relaunch' ] ) } ) app . exit ( 0 ) app.isReady() ​ 戻り値 boolean - Electron の初期化が完了している場合 true 、そうでない場合 false 。 app.whenReady() も参照してください。 app.whenReady() ​ Returns Promise<void> - Electron が初期化されるときに実行される Promise。 app.isReady() を確認してアプリの準備がまだできていないときに ready イベントに登録するための、便利な代替手段として使用できます。 app.focus([options]) ​ * options Object (任意) * steal boolean macOS - 他のアプリがアクティブな状態でも、レシーバのアプリをアクティブにします。 macOS では、アプリケーションがアクティブになります。 Windows では、アプリケーションの最初のウィンドウにフォーカスします。 Linux では、最初の表示されているウインドウにフォーカスするか (X11)、フォーカスを要求するかその代わりに通知の表示やアプリアイコンの点滅を行います (Wayland)。 steal オプションはできるだけ慎重に使用してください。 app.isActive() macOS ​ Returns boolean - true if the application is active (i.e. focused). app.hide() macOS ​ 最小化することなくアプリケーションのすべてのウインドウを非表示にします。 app.isHidden() macOS ​ 戻り値 boolean - アプリケーションがそのすべてのウィンドウを含めて (例えば Command-H で) 隠されている場合は true 、それ以外は false です。 app.show() macOS ​ 非表示にされたアプリケーションのウインドウを表示します。 自動的にフォーカスしません。 app.setAppLogsPath([path]) ​ * path string (任意) - ログのカスタムパス。 絶対パスでなければなりません。 アプリがロギングするディレクトリを設定または作成します。これは app.getPath() や app.setPath(pathName, newPath) で操作できます。 path 引数なしで app.setAppLogsPath() を呼び出すと、このディレクトリは、 macOS では ~/Library/Logs/アプリ名 に、 Linux と Windows では userData ディレクトリ内に設定されます。 app.getAppPath() ​ 戻り値 string - 現在のアプリケーションのディレクトリ。 app.getPath(name) ​ * name string - 以下のパスを名前で要求することができます。 * home ユーザのホームディレクトリ。 * appData - 既定のユーザ毎のアプリケーションデータディレクトリ。 * Windowsの場合、 %APPDATA% * Linuxの場合、 $XDG_CONFIG_HOME もしくは ~/.config * macOSの場合、 ~/Library/Application Support * assets アプリケーションのアセット ( resources.pak など) が格納されているディレクトリ。 デフォルトでは、これは exe パスを含むフォルダと同じです。 Windows と Linux で利用できます。 * userData アプリの設定ファイルが保存されるディレクトリで、既定ではアプリ名が加えられた appData のディレクトリ。 慣習上ユーザーデータを保存するファイルはこのディレクトリに書き込まれるはずですが、環境によってはこのディレクトリをクラウドストレージにバックアップすることもあるため、大きなファイルをここに書き込むことは非推奨です。 It is recommended to store app-specific files within a subdirectory of userData (e.g., path.join(app.getPath('userData'), 'my-app-data') ) rather than directly in userData itself, to avoid naming conflicts with Chromium's own subdirectories (such as Cache , GPUCache , and Local Storage ). * sessionData The directory for storing data generated by Session , such as localStorage, cookies, disk cache, downloaded dictionaries, network state, DevTools files. 既定ではこれは userData を指します。 Chromium はここに非常に大きなディスクキャッシュを書き込む可能性があるため、ユーザーデータの保存を localStorage や Cookie などのブラウザストレージに依存しないアプリの場合、 userData ディレクトリを汚染しないよう、このディレクトリを他の場所に設定することが推奨されます。 * temp 一時ディレクトリ。 * exe 現在の実行ファイル。 * module Chromiumモジュールの場所。 デフォルトでは、これは exe と同義です。 * desktop 現在のユーザのデスクトップディレクトリ。 * documents ユーザの"マイドキュメント"のディレクトリ。 * downloads ユーザのダウンロードのディレクトリ。 * music ユーザのミュージックのディレクトリ。 * pictures ユーザのピクチャのディレクトリ。 * videos ユーザのビデオのディレクトリ。 * recent ユーザーが最近開いたファイルのディレクトリ (Windows のみ)。 * logs アプリのログフォルダのディレクトリ。 * crashDumps クラッシュダンプを格納するディレクトリ。 戻り値 string - name に関連付けられた特別なディレクトリもしくはファイルのパス。 失敗した場合、 Error が送出されます。 If app.getPath('logs') is called without calling app.setAppLogsPath() being called first, a default log directory will be created equivalent to calling app.setAppLogsPath() without a path parameter. app.getFileIcon(path[, options]) ​ * path string * options Object (任意) * size string * small - 16x16 * normal - 32x32 * large - Linux の場合は 48x48、_Windows_の場合は 32x32、 macOS の場合はサポートされていません。 戻り値 Promise<NativeImage> - アプリのアイコンで解決され、これは NativeImage 型です。 パスに関連付けられているアイコンを取得します。 Windows の場合、2 種類のアイコンがあります。 * .mp3 、 .png など、特定のファイル拡張子に関連付けられたアイコン。 * .exe 、 .dll 、 .ico のような、ファイル自体に含まれるアイコン。 Linux と macOS の場合、アイコンはファイルの MIME タイプに関連付けられたアプリケーションによって決まります。 app.setPath(name, path) ​ * name string * path string name に関連付けられた特別なディレクトリもしくはファイルの path を上書きします。 パスとして存在しないディレクトリが指定された場合、 Error が投げられます。 その場合、そのディレクトリを fs.mkdirSync や類似のもので作成するべきです。 app.getPath で定義されている name のパスだけを上書きすることができます。 既定では、WebページのCookieとキャッシュは sessionData ディレクトリに保存されます。 この場所を変更するには、 app モジュールの ready イベントが発生する前に sessionData を上書きする必要があります。 app.getVersion() ​ 戻り値 string - ロードされたアプリケーションのバージョン。 アプリケーションの package.json ファイルにバージョンが見つからない場合、現在のバンドルもしくは実行可能ファイルのバージョンが返却されます。 app.getName() ​ 戻り値 string - アプリケーションの package.json ファイルで名前として設定された現在のアプリケーション名。 通常、 package.json の name フィールドは、npm のモジュール仕様に基づいて小文字だけの短い名前が設定されます。 通常、すべて大文字で始まるアプリケーションの名前となる productName フィールドも指定してください。Electronによって、 name よりも優先されます。 app.setName(name) ​ * name string 現在のアプリケーションの名前を上書きします。 [!NOTE] この関数は、Electron 内で使用する名前を上書きします。OS が使用する名前には影響しません。 app.setDesktopName(name) Linux ​ * name string - The .desktop filename (e.g. 'my-app.desktop' ). Sets the .desktop filename on Linux. This should match the base filename of the app's installed .desktop file. The .desktop suffix is optional. This value is used to determine the default XDG application ID on Wayland and WM_CLASS on X11. If it is not set, Electron will attempt to infer a name, but it may not match the packaged app's actual .desktop file. This could result in the app showing a generic icon or failing to respond to global keyboard shortcuts. This API must be called before the ready event. The value can also be set using desktopName in package.json . app.getLocale() ​ 戻り値 string - 現在のアプリケーションのロケールで、Chromium の l10n_util ライブラリを用いて取得されます。 取りうる戻り値については こちら にドキュメントがあります。 ロケールを設定するには、アプリケーションの起動時にコマンドラインスイッチを使用する必要があります。これについては、 こちら を参照してください。 [!NOTE] アプリをパッケージ化して配布する場合、 locales フォルダを同梱する必要があります。 [!NOTE] この API は ready イベントが発生した後に呼び出さなければなりません。