# app（アプリケーション）
以下は`app`の一般的な属性の例です：
```javascript
console.log(eagle.app.version); // Eagle のバージョン
console.log(eagle.app.build); // Eagle のビルド番号
console.log(eagle.app.locale); // アプリケーションの言語設定, en/zh_CN/zh_TW/ja_JP
console.log(eagle.app.arch); // x86 | x64
console.log(eagle.app.platform); // darwin | win32
console.log(eagle.app.isWindows); // true | false, 操作システムが Windows かどうか
console.log(eagle.app.isMac); // true | false, 操作システムが Mac かどうか
console.log(eagle.app.runningUnderARM64Translation); // Rosetta 変換モードで実行されているかどうか
```
## メソッド
## isDarkColors()
現在のシステムがダーク（Dark）モードであるかどうかを確認します。
* `boolean` を返します - 現在のシステムがダークモードであるかどうか。
```javascript
eagle.app.isDarkColors(); // true | false
```
## getPath(name)
以下のパスを名前でリクエストします。
* `name` string - 以下のパスを名前でリクエストします。
* `home` - ユーザーのホームフォルダ（メインディレクトリ）
* `appData` - 各ユーザーのアプリケーションデータディレクトリ、デフォルトでは：
* `userData` - アプリケーションの設定ファイルを保存するフォルダで、デフォルトは appData フォルダにアプリケーション名が追加されます。習慣的にユーザーが保存するデータファイルはこのディレクトリに書かれるべきですが、大きなファイルをここに書くことはお勧めしません。なぜなら、いくつかの環境ではこのディレクトリがクラウドストレージにバックアップされるためです。
* `temp` - 一時ファイルフォルダ
* `exe` - 現在の実行ファイル
* `desktop` - 現在のユーザーのデスクトップフォルダ
* `documents` - ユーザーのドキュメントディレクトリへのパス
* `downloads` - ユーザーのダウンロードディレクトリへのパス
* `music` - ユーザーの音楽ディレクトリへのパス
* `pictures` - ユーザーの画像ディレクトリへのパス
* `videos` - ユーザーのビデオディレクトリへのパス
* `recent` - ユーザーの最近使用したファイルのディレクトリ (Windows のみ)。
* `Promise` を返します - `path` はクエリパスの結果です。
```javascript
await eagle.app.getPath('appData'); // 'C:\Users\User\AppData\Roaming'
await eagle.app.getPath('pictures'); // 'C:\Users\User\Pictures'
await eagle.app.getPath('desktop'); // 'C:\Users\User\Desktop'
```
{% hint style="info" %}
備考：この機能は、Electron APIの[app.getPath](https://www.electronjs.org/zh/docs/latest/api/app#appgetapppath)と類似しています。
{% endhint %}
## getFileIcon(path\[, options])
指定されたパスのファイル関連のアイコンを取得します。
* `path` string - アイコンを取得したいファイルのパス
* `options` Object（オプション）
* `size` string
* `small` - 16x16
* `normal` - 32x32
* `large` - `Windows`は32x32、`macOS`はサポートされていません。
* 戻り値 `Promise`
* `img` [NativeImage](https://www.electronjs.org/zh/docs/latest/api/native-image) - NativeImageタイプのアプリアイコン。
```javascript
let img = await eagle.app.getFileIcon('path_to_file', { size: 'small' });
// 画像情報を取得する
let base64 = img.toDataURL();
let size = img.getSize(); // {'width': 16, height: 16}
// コンピュータに保存する
let buffer = img.toPNG();
require('fs').writeFileSync('output_path/example.png', buffer);
```
{% hint style="info" %}
備考：この機能は、Electron APIの[app.getAppIcon](https://www.electronjs.org/zh/docs/latest/api/app#appgetfileiconpath-options)と類似しています。
{% endhint %}
## createThumbnailFromPath(path, maxSize)
指定されたパスのファイル関連のアイコンを取得します。
* `path` string - サムネイル画像を取得したいファイルのパス
* `maxSize` Size - サムネイル画像の最大幅および高さ（正数）を返します。Windowsプラットフォームでは、maxSize.heightが無視され、maxSize.widthに応じて高さが縮小されます。
* 戻り値 `Promise`
* `img` [NativeImage](https://www.electronjs.org/zh/docs/latest/api/native-image) - ファイルのサムネイルプレビュー画像。
```javascript
let img = await eagle.app.createThumbnailFromPath('path_to_file', {
height: 200,
width: 200
});
// 画像情報を取得する
let base64 = img.toDataURL();
let size = img.getSize(); // {'width': 200, height: 150}
// コンピュータに保存する
let buffer = img.toPNG();
require('fs').writeFileSync('output_path/example.png', buffer);
```
{% hint style="info" %}
備考：この機能は、Electron APIの[nativeImage.createThumbnailFromPath(path, maxSize)](https://www.electronjs.org/zh/docs/latest/api/native-image#nativeimagecreatethumbnailfrompathpath-maxsize-macos-windows)と類似しています。
{% endhint %}
## show()
Eagle メインアプリケーションウィンドウを前面に表示します。
* `Promise` を返します - 操作が成功したかどうか。
```javascript
await eagle.app.show();
```
{% hint style="info" %}
注意：この機能には Eagle 4.0 build18 以降が必要です。
{% endhint %}
## 属性
## version
`string`属性、現在のEagleアプリケーションのバージョンを取得する。
## build
`number`属性、現在のEagleアプリケーションのBuild Numberを取得する。
## locale
`string`属性、現在のEagleアプリケーションのインターフェイス言語を取得する。
* `en` - 英語
* `zh_CN` - 簡体字中国語
* `zh_TW` - 繁体字中国語
* `ja_JP` - 日本語
* `ko_KR` - 韓国語
* `es_ES` - スペイン語
* `de_DE` - ドイツ語
* `ru_RU` - ロシア語
## arch
`string`属性、オペレーティングシステムのCPUアーキテクチャを返します。
* `x64`
* `arm64`
* `x86`
## platform
`string`属性、オペレーティングシステムプラットフォームを識別する文字列を返します。
* `darwin` - macOSオペレーティングシステム
* `win32` - Windowsオペレーティングシステム
## env
`Object`属性、環境変数のオブジェクトを返します。
```javascript
console.log(eagle.app.env);
{
APPDATA: "C:\\Users\\User\\AppData\\Roaming",
HOMEDRIVE: "C:",
HOMEPATH: "\\Users\\User",
LANG: "zh_TW.UTF-8",
TEMP: "C:\\Users\\User\\AppData\\Local\\Temp"
}
```
```javascript
console.log(eagle.app.env['TEMP']);
"C:\\Users\\User\\AppData\\Local\\Temp"
```
## execPath
`string`属性、現在のアプリケーションの実行パス。
```javascript
console.log(eagle.app.execPath);
"C:\\Program Files\\Eagle\\Eagle.exe"
```
## pid
`number`属性、現在のプラグインプロセスID。
## isWindows
`boolean`属性、現在のWindowオペレーティングシステムであるかどうか。
## isMac
`boolean`属性、現在のMacオペレーティングシステムであるかどうか。
## runningUnderARM64Translation
`boolean`属性、trueの場合、現在のアプリケーションがARM64ランタイム環境（例えばmacOS [Rosetta Translator Environment](https://en.wikipedia.org/wiki/Rosetta_\(software\)) や Windows [WOW](https://en.wikipedia.org/wiki/Windows_on_Windows) を使用しています。
{% hint style="info" %}
ヒント：Electron APIの[app.runningUnderARM64Translation](https://www.electronjs.org/zh/docs/latest/api/app#apprunningunderarm64translation-%E5%8F%AA%E8%AF%BB-macos-windows) と同様の機能です。このプロパティは、ユーザーが誤って変換環境の下でx64バージョンを実行している時に、アプリケーションのarm64バージョンのダウンロードを促すために使用できます。
{% endhint %}
## theme
`string`属性、現在のテーマカラーの名前です。例：`LIGHT`、`LIGHTGRAY`、`GRAY`、`DARK`、`BLUE`、`PURPLE`。
## userDataPath
`string`属性、現在のユーザーデータディレクトリのパス。
```javascript
console.log(eagle.app.userDataPath);
"C:\\Users\\User\\AppData\\Roaming\\Eagle"
```
{% hint style="info" %}
注意：この機能にはEagle 4.0 build12以降が必要です。
{% endhint %}
###