Merge pull request #6125 from leo/master

Replace "Mac OS" and "OS X" with "macOS"
This commit is contained in:
Cheng Zhao 2016-06-19 10:53:43 +00:00 committed by GitHub
commit 78193a0608
157 changed files with 650 additions and 650 deletions

View file

@ -68,7 +68,7 @@
* :non-potable_water: `:non-potable_water:` 메모리 누수를 연결했을 때
* :memo: `:memo:` 문서를 작성했을 때
* :penguin: `:penguin:` Linux에 대한 패치를 했을 때
* :apple: `:apple:` Mac OS에 대한 패치를 했을 때
* :apple: `:apple:` macOS에 대한 패치를 했을 때
* :checkered_flag: `:checkered_flag:` Windows에 대한 패치를 했을 때
* :bug: `:bug:` 버그를 고쳤을 때
* :fire: `:fire:` 코드 또는 파일을 삭제했을 때

View file

@ -65,7 +65,7 @@ possible with your report. If you can, please include:
* :non-potable_water: `:non-potable_water:` when plugging memory leaks
* :memo: `:memo:` when writing docs
* :penguin: `:penguin:` when fixing something on Linux
* :apple: `:apple:` when fixing something on Mac OS
* :apple: `:apple:` when fixing something on macOS
* :checkered_flag: `:checkered_flag:` when fixing something on Windows
* :bug: `:bug:` when fixing a bug
* :fire: `:fire:` when removing code or files

View file

@ -22,7 +22,7 @@ Electron에 대한 중요한 알림을 받고 싶다면 Twitter에서
## 다운로드
Linux, Windows, OS X 용으로 미리 빌드된 Electron 바이너리와 디버그 심볼이 준비되어
Linux, Windows, macOS 용으로 미리 빌드된 Electron 바이너리와 디버그 심볼이 준비되어
있습니다. [releases](https://github.com/electron/electron/releases) 페이지에서
받아 볼 수 있습니다.

View file

@ -19,7 +19,7 @@ behavior to electron@github.com.
## Downloads
Prebuilt binaries and debug symbols of Electron for Linux, Windows and OS X can
Prebuilt binaries and debug symbols of Electron for Linux, Windows and macOS can
be found on the [releases](https://github.com/electron/electron/releases) page.
You can also use [`npm`](https://docs.npmjs.com/) to install prebuilt electron

View file

@ -148,7 +148,7 @@ void AtomBrowserMainParts::PreMainMessageLoopRun() {
#endif
#if !defined(OS_MACOSX)
// The corresponding call in OS X is in AtomApplicationDelegate.
// The corresponding call in macOS is in AtomApplicationDelegate.
Browser::Get()->WillFinishLaunching();
Browser::Get()->DidFinishLaunching();
#endif

View file

@ -58,7 +58,7 @@ bool Browser::RemoveAsDefaultProtocolClient(const std::string& protocol) {
if (!bundleList) {
return false;
}
// On Mac OS X, we can't query the default, but the handlers list seems to put
// On macOS, we can't query the default, but the handlers list seems to put
// Apple's defaults first, so we'll use the first option that isn't our bundle
CFStringRef other = nil;
for (CFIndex i = 0; i < CFArrayGetCount(bundleList); i++) {

View file

@ -33,7 +33,7 @@ class BrowserObserver {
virtual void OnQuit() {}
// The browser has opened a file by double clicking in Finder or dragging the
// file to the Dock icon. (OS X only)
// file to the Dock icon. (macOS only)
virtual void OnOpenFile(bool* prevent_default,
const std::string& file_path) {}
@ -53,7 +53,7 @@ class BrowserObserver {
const base::DictionaryValue& request_details) {}
#if defined(OS_MACOSX)
// The browser wants to resume a user activity via handoff. (OS X only)
// The browser wants to resume a user activity via handoff. (macOS only)
virtual void OnContinueUserActivity(
bool* prevent_default,
const std::string& type,

View file

@ -320,7 +320,7 @@ class NativeWindow : public base::SupportsUserData,
base::CancelableClosure window_unresposive_closure_;
// Used to display sheets at the appropriate horizontal and vertical offsets
// on OS X.
// on macOS.
double sheet_offset_x_;
double sheet_offset_y_;

View file

@ -232,7 +232,7 @@ bool ScopedDisableResize::disable_resize_ = false;
}
- (void)windowDidExitFullScreen:(NSNotification*)notification {
// For certain versions of OS X the fullscreen button will automatically show
// For certain versions of macOS the fullscreen button will automatically show
// after exiting fullscreen mode.
if (!shell_->has_frame()) {
NSWindow* window = shell_->GetNativeWindow();
@ -537,7 +537,7 @@ NativeWindowMac::NativeWindowMac(
[window_ setToolbar:toolbar];
}
// On OS X the initial window size doesn't include window frame.
// On macOS the initial window size doesn't include window frame.
bool use_content_size = false;
options.Get(options::kUseContentSize, &use_content_size);
if (!has_frame() || !use_content_size)
@ -1041,7 +1041,7 @@ void NativeWindowMac::InstallView() {
[[window_ standardWindowButton:NSWindowMiniaturizeButton] setHidden:YES];
[[window_ standardWindowButton:NSWindowCloseButton] setHidden:YES];
// Some third-party OS X utilities check the zoom button's enabled state to
// Some third-party macOS utilities check the zoom button's enabled state to
// determine whether to show custom UI on hover, so we disable it here to
// prevent them from doing so in a frameless app window.
[[window_ standardWindowButton:NSWindowZoomButton] setEnabled:NO];
@ -1111,7 +1111,7 @@ void NativeWindowMac::SetStyleMask(bool on, NSUInteger flag) {
else
[window_ setStyleMask:[window_ styleMask] & (~flag)];
// Change style mask will make the zoom button revert to default, probably
// a bug of Cocoa or OS X.
// a bug of Cocoa or macOS.
if (!zoom_button_enabled)
SetMaximizable(false);
}
@ -1123,7 +1123,7 @@ void NativeWindowMac::SetCollectionBehavior(bool on, NSUInteger flag) {
else
[window_ setCollectionBehavior:[window_ collectionBehavior] & (~flag)];
// Change collectionBehavior will make the zoom button revert to default,
// probably a bug of Cocoa or OS X.
// probably a bug of Cocoa or macOS.
if (!zoom_button_enabled)
SetMaximizable(false);
}

View file

@ -79,7 +79,7 @@ NSAlert* CreateNSAlert(NativeWindow* parent_window,
for (size_t i = 0; i < buttons.size(); ++i) {
NSString* title = base::SysUTF8ToNSString(buttons[i]);
// An empty title causes crash on OS X.
// An empty title causes crash on macOS.
if (buttons[i].empty())
title = @"(empty)";
NSButton* button = [alert addButtonWithTitle:title];

View file

@ -40,11 +40,11 @@ class TrayIcon {
virtual void SetToolTip(const std::string& tool_tip) = 0;
// Sets the title displayed aside of the status icon in the status bar. This
// only works on OS X.
// only works on macOS.
virtual void SetTitle(const std::string& title);
// Sets whether the status icon is highlighted when it is clicked. This only
// works on OS X.
// works on macOS.
virtual void SetHighlightMode(bool highlight);
// Displays a notification balloon with the specified contents.

View file

@ -12,9 +12,9 @@
namespace {
// By default, OS X sets 4px to tray image as left and right padding margin.
// By default, macOS sets 4px to tray image as left and right padding margin.
const CGFloat kHorizontalMargin = 4;
// OS X tends to make the title 2px lower.
// macOS tends to make the title 2px lower.
const CGFloat kVerticalTitleMargin = 2;
} // namespace

View file

@ -64,7 +64,7 @@ v8::Local<v8::Value> GetSystemMemoryInfo(v8::Isolate* isolate,
dict.Set("total", mem_info.total);
dict.Set("free", mem_info.free);
// NB: These return bogus values on OS X
// NB: These return bogus values on macOS
#if !defined(OS_MACOSX)
dict.Set("swapTotal", mem_info.swap_total);
dict.Set("swapFree", mem_info.swap_free);

View file

@ -22,7 +22,7 @@
#undef DISALLOW_COPY_AND_ASSIGN
#undef NO_RETURN
#undef arraysize
#undef debug_string // This is defined in OS X 10.9 SDK in AssertMacros.h.
#undef debug_string // This is defined in macOS 10.9 SDK in AssertMacros.h.
#include "vendor/node/src/env.h"
#include "vendor/node/src/env-inl.h"
#include "vendor/node/src/node.h"

View file

@ -66,7 +66,7 @@ const char kType[] = "type";
// Disable auto-hiding cursor.
const char kDisableAutoHideCursor[] = "disableAutoHideCursor";
// Use the OS X's standard window instead of the textured window.
// Use the macOS' standard window instead of the textured window.
const char kStandardWindow[] = "standardWindow";
// Default browser window background color.

View file

@ -124,7 +124,7 @@
],
'conditions': [
['OS=="mac" and libchromiumcontent_component==0', {
# -all_load is the "whole-archive" on OS X.
# -all_load is the "whole-archive" on macOS.
'xcode_settings': {
'OTHER_LDFLAGS': [ '-Wl,-all_load' ],
},

View file

@ -38,7 +38,7 @@ El objeto `process` tiene los siguientes métodos:
Interrumpe el hilo principal del proceso actual.
### process.setFdLimit(maxDescriptors) _OS X_ _Linux_
### process.setFdLimit(maxDescriptors) _macOS_ _Linux_
* `maxDescriptors` Integer

View file

@ -1,9 +1,9 @@
#Instrucciones de Compilación (Mac)
Siga las siguientes pautas para la construcción de Electron en OS X.
Siga las siguientes pautas para la construcción de Electron en macOS.
#Requisitos previos
`OS X >= 10.8`
`macOS >= 10.8`
`Xcode >= 5.1`
`node.js (external)`
@ -36,7 +36,7 @@ Después de la construcción está hecho, usted puede encontrar `Electron.app` b
#Soporte de 32bit
Electron sólo puede construirse para un objetivo de 64 bits en OS X y no hay un plan para apoyar a 32 bit OS X en el futuro.
Electron sólo puede construirse para un objetivo de 64 bits en macOS y no hay un plan para apoyar a 32 bit macOS en el futuro.
#Pruebas

View file

@ -26,7 +26,7 @@ Estas son las maneras en las que construimos la documentación de Electron.
- Argumentos opcionales son denotados cuando se llaman en listas.
- Delimitador de línea de 80-columnas.
- Métodos específicos de Plataformas son denotados en itálicas seguidas por la cabecera del método.
- ```### `method(foo, bar)` _OS X_```
- ```### `method(foo, bar)` _macOS_```
- Preferir 'en el ___ proceso' en lugar de 'sobre el'
### Traducciones de la Documentación

View file

@ -5,7 +5,7 @@ aplicación deberá llamarse `app`, y ser colocado debajo del directorio de
recursos de Electron (en OSX es `Electron.app/Contents/Resources/`, en Linux y
Windows es `resources/`), de esta forma:
En OS X:
En macOS:
```text
electron/Electron.app/Contents/Resources/app/
@ -37,7 +37,7 @@ Para utilizar un archivo `asar` en reemplazo del directorio `app`, debes de
renombrar el archivo a `app.asar`, y colocarlo por debajo el directorio de recursos
de Electron (ver en seguida), Electron intentará leer el archivo y arrancar desde el.
En OS X:
En macOS:
```text
electron/Electron.app/Contents/Resources/

View file

@ -6,9 +6,9 @@ en la JumpList de la barra de tareas, y en Mac, las aplicaciones pueden agregar
Esta guía explica cómo integrar tu aplicación en esos entornos de escritorio a través de las APIs de Electron.
## Documentos recientes (Windows y OS X)
## Documentos recientes (Windows y macOS)
Windows y OS X proveen un acceso sencillo a la lista de documentos recientes.
Windows y macOS proveen un acceso sencillo a la lista de documentos recientes.
__JumpList:__
@ -42,14 +42,14 @@ registrar tu aplicación en [Application Registration][app-registration].
Cuando un usuario haga click en un archivo de la JumpList, una nueva instancia de tu aplicación
se iniciará, la ruta del archivo se agregará como un argumento de la línea de comandos.
### Notas sobre OS X
### Notas sobre macOS
Cuando un archivo es solicitado desde el menú de documentos recientes, el evento `open-file`
del módulo `app` será emitido.
## Menú dock personalizado (OS X)
## Menú dock personalizado (macOS)
OS X permite a los desarrolladores definir un menú personalizado para el dock,
macOS permite a los desarrolladores definir un menú personalizado para el dock,
el cual usualmente contiene algunos accesos directos a las características más comunes
de tu aplicación:
@ -99,7 +99,7 @@ __Tareas de Internet Explorer:__
![IE](http://i.msdn.microsoft.com/dynimg/IC420539.png)
A diferencia del menú dock en OS X, el cual es un menú real, las tareas de usuario en Windows
A diferencia del menú dock en macOS, el cual es un menú real, las tareas de usuario en Windows
funcionan como accesos directos de aplicación, que al ser clickeados, lanzan el programa
con argumentos específicos.

View file

@ -74,7 +74,7 @@ var mainWindow = null;
// Salir de todas las ventanas cuando se cierren.
app.on('window-all-closed', function() {
// En OS X es común que las aplicaciones y su barra de menú
// En macOS es común que las aplicaciones y su barra de menú
// se mantengan activas hasta que el usuario cierre la aplicación
// explícitamente utilizando Cmd + Q
if (process.platform != 'darwin') {
@ -139,7 +139,7 @@ En Linux:
$ ./electron/electron your-app/
```
En OS X:
En macOS:
```bash
$ ./Electron.app/Contents/MacOS/Electron your-app/

View file

@ -2,10 +2,10 @@
Las siguientes plataformas son soportadas por Electron:
### OS X
### macOS
Sólo se proveen binarios de 64 bit para OS X.
La versión mínima soportada es OS X 10.8.
Sólo se proveen binarios de 64 bit para macOS.
La versión mínima soportada es macOS 10.8.
### Windows

View file

@ -28,7 +28,7 @@ app.on('window-all-closed', function() {
// Specify flash path.
// On Windows, it might be /path/to/pepflashplayer.dll
// On OS X, /path/to/PepperFlashPlayer.plugin
// On macOS, /path/to/PepperFlashPlayer.plugin
// On Linux, /path/to/libpepflashplayer.so
app.commandLine.appendSwitch('ppapi-flash-path', '/path/to/libpepflashplayer.so');

View file

@ -85,7 +85,7 @@ dans la FAQ :
* [Hiérarchie du Code Source](development/source-code-directory-structure.md)
* [Différences Techniques par rapport à NW.js (anciennement node-webkit)](development/atom-shell-vs-node-webkit.md)
* [Aperçu du Système de Build](development/build-system-overview.md)
* [Instructions de Build (OS X)](development/build-instructions-osx.md)
* [Instructions de Build (macOS)](development/build-instructions-osx.md)
* [Instructions de Build (Windows)](development/build-instructions-windows.md)
* [Instructions de Build (Linux)](development/build-instructions-linux.md)
* [Installer un Serveur de Symbol dans le debugger](development/setting-up-symbol-server.md)

View file

@ -27,7 +27,7 @@ La documentation d'Electron a été écrite en suivant les règles ci-dessous :
- Les arguments optionnels sont indiqués quand appelés dans la liste.
- La longueur des lignes ne dépasse pas 80 caractères.
- Les méthodes spécifiques à une plateforme sont notées en italique.
- ```### `method(foo, bar)` _OS X_```
- ```### `method(foo, bar)` _macOS_```
- Préférer 'in the ___ process' au lieu de 'on'
### Traductions de la Documentation

View file

@ -89,7 +89,7 @@ _リンクになっていないリストは未翻訳のものです。_
* Source Code Directory Structure (development/source-code-directory-structure.md)
* Technical Differences to NW.js (formerly node-webkit)(development/atom-shell-vs-node-webkit.md)
* Build System Overview (development/build-system-overview.md)
* Build Instructions (OS X) (development/build-instructions-osx.md)
* Build Instructions (macOS) (development/build-instructions-osx.md)
* Build Instructions (Windows) (development/build-instructions-windows.md)
* Build Instructions (Linux) (development/build-instructions-linux.md)
* Debug Instructions (Windows) (development/debug-instructions-windows.md)

View file

@ -10,9 +10,9 @@ acceleratorは、キーボードショートカットを示す文字列です。
## プラットフォームの留意点
OS Xでは`Command` キー、LinuxとWindowsでは`Control` キーを意味する`CommandOrControl`はいくつかのacceleratorを定義しますが、LinuxとWindowsでは、`Command` キーは何の効果もありません。
macOSでは`Command` キー、LinuxとWindowsでは`Control` キーを意味する`CommandOrControl`はいくつかのacceleratorを定義しますが、LinuxとWindowsでは、`Command` キーは何の効果もありません。
`Super` キーは、WindowsとLinuxでは `Windows` キーに、OS Xでは、`Cmd` キーに関連付けられます。
`Super` キーは、WindowsとLinuxでは `Windows` キーに、macOSでは、`Cmd` キーに関連付けられます。
## 提供されている修飾語句

View file

@ -17,7 +17,7 @@ app.on('window-all-closed', function() {
### イベント: 'will-finish-launching'
アプリケーションの基礎起動が終わったときに出力されます。Windows と Linuxでは、 `will-finish-launching` イベントと`ready`イベントは同じです。OS Xでは、`NSApplication`の `applicationWillFinishLaunching` 通知をに相当します。通常、`open-file`と`open-url` 用のリスナーの設定、クラッシュレポートの開始、自動アップデートをします。
アプリケーションの基礎起動が終わったときに出力されます。Windows と Linuxでは、 `will-finish-launching` イベントと`ready`イベントは同じです。macOSでは、`NSApplication`の `applicationWillFinishLaunching` 通知をに相当します。通常、`open-file`と`open-url` 用のリスナーの設定、クラッシュレポートの開始、自動アップデートをします。
ほとんどの場合、 `ready` イベントハンドラーですべてをするべきです。
@ -58,7 +58,7 @@ Electronの初期化が終わった時に出力します。
アプリケーションが終了したときに出力されます。
### イベント: 'open-file' _OS X_
### イベント: 'open-file' _macOS_
戻り値:
@ -71,7 +71,7 @@ Electronの初期化が終わった時に出力します。
Windowsでは、ファイルパスを取得するために、 `process.argv` をパースする必要があります。
### イベント: 'open-url' _OS X_
### イベント: 'open-url' _macOS_
戻り値:
@ -82,7 +82,7 @@ Windowsでは、ファイルパスを取得するために、 `process.argv` を
このイベントをハンドルしたい場合は、`event.preventDefault()`をコールすべきです。
### イベント: 'activate' _OS X_
### イベント: 'activate' _macOS_
戻り値:
@ -237,7 +237,7 @@ gpu プロセスがクラッシュしたときに出力されます。
* `appData` 既定で示すユーザーごとのアプリケーションディレクトリ
* `%APPDATA%` Windows上
* `$XDG_CONFIG_HOME` or `~/.config` Linux上
* `~/Library/Application Support` OS X
* `~/Library/Application Support` macOS上
* `userData` アプリの設定ファイルを格納するディレクトリで、既定では`appData` ディレクトリ配下のアプリ名ディレクトリです
* `temp` 一時ディレクトリ
* `exe` 現在の実行ファイル
@ -274,15 +274,15 @@ gpu プロセスがクラッシュしたときに出力されます。
現在のアプリケーションのロケールを戻します。
### `app.addRecentDocument(path)` _OS X_ _Windows_
### `app.addRecentDocument(path)` _macOS_ _Windows_
* `path` String
最近のドキュメント一覧に`path`を追加します。
この一覧はOSが管理しています。Windowsではタスクバーからこの一覧を見れ、OS Xではdockメニューから見れます。
この一覧はOSが管理しています。Windowsではタスクバーからこの一覧を見れ、macOSではdockメニューから見れます。
### `app.clearRecentDocuments()` _OS X_ _Windows_
### `app.clearRecentDocuments()` _macOS_ _Windows_
最近のドキュメント一覧をクリアします。
@ -321,7 +321,7 @@ The `callback` は、 `app`の`ready` イベントの出力後に実行するこ
プロセスがアプリケーションのプライマリインスタンスでアプリがロードし続けるなら、このメソッドは `false`を戻します。プロセスがほかのインスタンスにパラメーターを送信し、`true`を戻すと、直ちに終了します。
OS Xは、ユーザーがFinderで2つ目のアプリインスタンスを開いたり、`open-file` 、 `open-url`イベントが出力しようとすると、システムが自動的にシングルインスタンスを強制します。しかし、コマンドラインでアプリを開始するとシステムのシングルインスタンスメカニズムは無視されるので、シングルインスタンスを強制するためには、このメソッドを使う必要があります。
macOSは、ユーザーがFinderで2つ目のアプリインスタンスを開いたり、`open-file` 、 `open-url`イベントが出力しようとすると、システムが自動的にシングルインスタンスを強制します。しかし、コマンドラインでアプリを開始するとシステムのシングルインスタンスメカニズムは無視されるので、シングルインスタンスを強制するためには、このメソッドを使う必要があります。
2つ目のインスタンスを起動するとき、メインのインスタンスのウィンドウをアクティブにする例
@ -392,7 +392,7 @@ Chromiumのコマンドダインに引数を追加します。引数は正しく
**Note:** `process.argv`に影響しません。
### `app.dock.bounce([type])` _OS X_
### `app.dock.bounce([type])` _macOS_
* `type` String (optional) - `critical` または `informational`を指定できます。既定では、 `informational`です。
@ -402,37 +402,37 @@ Chromiumのコマンドダインに引数を追加します。引数は正しく
リクエストを示すIDを戻します。
### `app.dock.cancelBounce(id)` _OS X_
### `app.dock.cancelBounce(id)` _macOS_
* `id` Integer
`id`のバウンスをキャンセルします。
### `app.dock.setBadge(text)` _OS X_
### `app.dock.setBadge(text)` _macOS_
* `text` String
dockのバッジエリアで表示する文字列を設定します。
### `app.dock.getBadge()` _OS X_
### `app.dock.getBadge()` _macOS_
dockのバッジ文字列を戻します。
### `app.dock.hide()` _OS X_
### `app.dock.hide()` _macOS_
dock アイコンを隠します。
### `app.dock.show()` _OS X_
### `app.dock.show()` _macOS_
dock アイコンを表示します。
### `app.dock.setMenu(menu)` _OS X_
### `app.dock.setMenu(menu)` _macOS_
* `menu` Menu
アプリケーションの[dock menu][dock-menu]を設定します。
### `app.dock.setIcon(image)` _OS X_
### `app.dock.setIcon(image)` _macOS_
* `image` [NativeImage](native-image.md)

View file

@ -6,9 +6,9 @@
`autoUpdater`は、異なるプラットフォーム用に統一したAPIを提供していますが、それぞれのプラットフォーム上で、まだ多少の差があります。
### OS X
### macOS
OS Xでは、 `autoUpdater` モジュールは、[Squirrel.Mac][squirrel-mac]上に構築されていて、動作させるのに特別な設定が不要であることを意味します。サーバーサイドの要件は、[Server Support][server-support]を読んでください。
macOSでは、 `autoUpdater` モジュールは、[Squirrel.Mac][squirrel-mac]上に構築されていて、動作させるのに特別な設定が不要であることを意味します。サーバーサイドの要件は、[Server Support][server-support]を読んでください。
### Windows
@ -16,7 +16,7 @@ Windowsでは、auto-updaterを使う前に、ユーザーのPCにアプリを
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] を参照してください。
サーバーサイドのセットアップは、macOSと異なります。詳細は、[Squirrel.Windows][squirrel-windows] を参照してください。
### Linux

View file

@ -37,7 +37,7 @@ crashReporter.start({
他の`crashReporter`APIを使用する前にこのメソッドをコールする必要があります。
**Note:** OS Xでは、Electronは、WindowsとLinux上の`breakpad` とは異なる、新しい`crashpad`クライアントを使用します。クラッシュ収集機能を有効にするために、メインプロセスや、クラッシュレポートを収集したいそれぞれのレンダラープロセスで、`crashpad`を初期化するために`crashReporter.start`APIをコールする必要があります。
**Note:** macOSでは、Electronは、WindowsとLinux上の`breakpad` とは異なる、新しい`crashpad`クライアントを使用します。クラッシュ収集機能を有効にするために、メインプロセスや、クラッシュレポートを収集したいそれぞれのレンダラープロセスで、`crashpad`を初期化するために`crashReporter.start`APIをコールする必要があります。
### `crashReporter.getLastCrashReport()`

View file

@ -10,7 +10,7 @@ const dialog = require('electron').dialog;
console.log(dialog.showOpenDialog({ properties: [ 'openFile', 'openDirectory', 'multiSelections' ]}));
```
**Note for OS X**: シートとしてダイアログを表示したい場合、唯一しなければならないことは、`browserWindow`パラメーターを参照する`BrowserWindow`を提供することです。
**Note for macOS**: シートとしてダイアログを表示したい場合、唯一しなければならないことは、`browserWindow`パラメーターを参照する`BrowserWindow`を提供することです。
## メソッド
@ -73,7 +73,7 @@ console.log(dialog.showOpenDialog({ properties: [ 'openFile', 'openDirectory', '
* `message` String - メッセージボックスのコンテンツ。
* `detail` String - メッセージの外部情報
* `icon` [NativeImage](native-image.md)
* `cancelId` Integer - ダイアログのボタンをクリックする代わりにユーザーがダイアログをキャンセルしたときに返す値です。既定では、ラベルの "cancel"や"no"を持つボタンのインデックスまたは、そのようなボタンが無ければ0を返します。OS XやWindowsでは、 すでに指定されているかどうかは関係なく、"Cancel"ボタンのインデックスはいつでも `cancelId`が使われます。
* `cancelId` Integer - ダイアログのボタンをクリックする代わりにユーザーがダイアログをキャンセルしたときに返す値です。既定では、ラベルの "cancel"や"no"を持つボタンのインデックスまたは、そのようなボタンが無ければ0を返します。macOSやWindowsでは、 すでに指定されているかどうかは関係なく、"Cancel"ボタンのインデックスはいつでも `cancelId`が使われます。
* `noLink` Boolean - Windowsでは、Electronは、 ("Cancel" または "Yes"のような)共通ボタンである`buttons`の一つを見つけようとし、ダイアログ内のコマンドリンクとして表示します。この挙動が気に入らない場合は、 `noLink``true`に設定できます。
* `callback` Function

View file

@ -11,9 +11,9 @@ const BrowserWindow = require('electron').BrowserWindow;
var win = new BrowserWindow({ width: 800, height: 600, frame: false });
```
### OS Xでの別の方法
### macOSでの別の方法
Mac OS X 10.10 Yosemite以降では、Chrome無しのウィンドウを指定する方法があります。`frame`を`false`に設定しタイトルバーとウィンドウコントロールの両方を無効にする代わりに、タイトルバーを隠しコンテンツをフルウィンドウサイズに広げたいけど、標準的なウィンドウ操作用にウィンドウコントロール("トラフィックライト")を維持したいかもしれません。新しい`titleBarStyle`オプションを指定することで、そうできます。
macOS 10.10 Yosemite以降では、Chrome無しのウィンドウを指定する方法があります。`frame`を`false`に設定しタイトルバーとウィンドウコントロールの両方を無効にする代わりに、タイトルバーを隠しコンテンツをフルウィンドウサイズに広げたいけど、標準的なウィンドウ操作用にウィンドウコントロール("トラフィックライト")を維持したいかもしれません。新しい`titleBarStyle`オプションを指定することで、そうできます。
```javascript
var win = new BrowserWindow({ 'titleBarStyle': 'hidden' });

View file

@ -38,7 +38,7 @@
* `minimize` - 現在のウィンドウの最小化
* `close` - 現在のウィンドウを閉じます
OS Xでは、`role`は次の追加の値を取れます:
macOSでは、`role`は次の追加の値を取れます:
* `about` - `orderFrontStandardAboutPanel`動作に紐づけられます
* `hide` - `hide`動作に紐づけられます

View file

@ -208,9 +208,9 @@ Menu.setApplicationMenu(menu);
* `menu` Menu
OS Xで、アプリケーションメニューとして`menu`を設定します。WindowsとLinuxでは、`menu`はそれぞれのウィンドウの上のメニューとして設定されます。
macOSで、アプリケーションメニューとして`menu`を設定します。WindowsとLinuxでは、`menu`はそれぞれのウィンドウの上のメニューとして設定されます。
### `Menu.sendActionToFirstResponder(action)` _OS X_
### `Menu.sendActionToFirstResponder(action)` _macOS_
* `action` String
@ -229,7 +229,7 @@ OS Xで、アプリケーションメニューとして`menu`を設定します
* `browserWindow` BrowserWindow (オプション) - 既定では`null`です。
* `x` Number (オプション) - 既定では -1です。
* `y` Number (**必須** `x` が使われている場合) - 既定では -1です。
* `positioningItem` Number (オプション) _OS X_ - 既定では -1です。
* `positioningItem` Number (オプション) _macOS_ - 既定では -1です。
メニューアイテムのインデックスを指定した座標にマウスカーソルを配置します。
@ -252,13 +252,13 @@ OS Xで、アプリケーションメニューとして`menu`を設定します
メニューのアイテムを収容した配列を取得します。
## OS X アプリケーションメニューの注意事項
## macOS アプリケーションメニューの注意事項
OS Xは、WindowsとLinuxのアプリケーションのメニューとは完全に異なるスタイルを持ち、よりネイティブのようにアプリメニューを作成するのに幾つかの注意事項があります。
macOSは、WindowsとLinuxのアプリケーションのメニューとは完全に異なるスタイルを持ち、よりネイティブのようにアプリメニューを作成するのに幾つかの注意事項があります。
### 標準的なメニュー
OS Xでは、`Services`と`Windows`メニューのように定義された標準的な多くのメニューがあります。標準的なメニューを作成するために、メニューの`role`に次のどれかを設定する必要があり、Electronはそれを受けて標準的なメニューを作成します。
macOSでは、`Services`と`Windows`メニューのように定義された標準的な多くのメニューがあります。標準的なメニューを作成するために、メニューの`role`に次のどれかを設定する必要があり、Electronはそれを受けて標準的なメニューを作成します。
* `window`
* `help`
@ -266,11 +266,11 @@ OS Xでは、`Services`と`Windows`メニューのように定義された標準
### 標準的なメニューアイテムの動作
`About xxx`と`Hide xxx`、`Hide Others`のようないくつかのメニューアイテム用にOS Xは標準的な動作を提供します。メニューアイテムの動作に標準的な動作を設定するために、メニューアイテムの`role`属性を設定すべきです。
`About xxx`と`Hide xxx`、`Hide Others`のようないくつかのメニューアイテム用にmacOSは標準的な動作を提供します。メニューアイテムの動作に標準的な動作を設定するために、メニューアイテムの`role`属性を設定すべきです。
### メインのメニュー名
OS Xでは、設定したラベルに関係なく、アプリケーションの最初のアイテムのラベルはいつもアプリの名前です。変更するために、アプリにバンドルされている`Info.plist`ファイルを修正してアプリの名前を変更する必要があります。詳細は、 [About Information Property List Files][AboutInformationPropertyListFiles] を見てください。
macOSでは、設定したラベルに関係なく、アプリケーションの最初のアイテムのラベルはいつもアプリの名前です。変更するために、アプリにバンドルされている`Info.plist`ファイルを修正してアプリの名前を変更する必要があります。詳細は、 [About Information Property List Files][AboutInformationPropertyListFiles] を見てください。
## メニューアイテムの位置

View file

@ -66,7 +66,7 @@ var appIcon = new Tray('/Users/somebody/images/icon.png');
もっとも一般的なケースは、ライトとダークなメニュバー両方に切り替え可能なメニュバーアイコン用にテンプレート画像を使います。
**Note:** テンプレート画像は、OS Xでのみサポートしています。
**Note:** テンプレート画像は、macOSでのみサポートしています。
テンプレート画像として画像をマークするために、ファイル名の最後に`Template`をつけます。

View file

@ -72,7 +72,7 @@ Windows Store App (appx)として動作中の場合は、値は`true`になり
このプロセスのメインスレッドをハングさせます。
### `process.setFdLimit(maxDescriptors)` _OS X_ _Linux_
### `process.setFdLimit(maxDescriptors)` _macOS_ _Linux_
* `maxDescriptors` Integer

View file

@ -63,9 +63,9 @@ __プラットフォームの制限:__
トレイアイコンがクリックされたときに出力されます。
__Note:__ `バウンド` 再生はOS XとWindoesのみで実装されています。
__Note:__ `バウンド` 再生はmacOSとWindoesのみで実装されています。
### イベント: 'right-click' _OS X_ _Windows_
### イベント: 'right-click' _macOS_ _Windows_
* `event` Event
* `altKey` Boolean
@ -80,7 +80,7 @@ __Note:__ `バウンド` 再生はOS XとWindoesのみで実装されていま
トレイアイコンが右クリックされると出力されます。
### イベント: 'double-click' _OS X_ _Windows_
### イベント: 'double-click' _macOS_ _Windows_
* `event` Event
* `altKey` Boolean
@ -107,26 +107,26 @@ __Note:__ `バウンド` 再生はOS XとWindoesのみで実装されていま
タイムアウトもしくはユーザーの操作で閉じて、トレイバルーンがクロースされたときに出力されます。
### イベント: 'drop' _OS X_
### イベント: 'drop' _macOS_
トレイアイコンでアイテムがドラグアンドドロップされたときに出力されます。
### イベント: 'drop-files' _OS X_
### イベント: 'drop-files' _macOS_
* `event`
* `files` Array - ドロップされたアイテムのフルパス
トレイアイコンでファイルがドロップされたときに出力されます。
### イベント: 'drag-enter' _OS X_
### イベント: 'drag-enter' _macOS_
トレイアイコンにドラッグ操作が入ったときに出力されます。
### イベント: 'drag-leave' _OS X_
### イベント: 'drag-leave' _macOS_
トレイアイコンででドラッグ操作が行われたときに出力されます。
### イベント: 'drag-end' _OS X_
### イベント: 'drag-end' _macOS_
トレイ上でドラッグ操作が終了したか、ほかの場所で終了したときに出力されます。
@ -146,11 +146,11 @@ __Note:__ `バウンド` 再生はOS XとWindoesのみで実装されていま
トレイアイコンの`image`を設定します。
### `Tray.setPressedImage(image)` _OS X_
### `Tray.setPressedImage(image)` _macOS_
* `image` [NativeImage](native-image.md)
OS Xで押されたときにトレイアイコンの`image`を設定します。
macOSで押されたときにトレイアイコンの`image`を設定します。
### `Tray.setToolTip(toolTip)`
@ -158,13 +158,13 @@ OS Xで押されたときにトレイアイコンの`image`を設定します。
トレイアイコン用のホバーテキストを設定します。
### `Tray.setTitle(title)` _OS X_
### `Tray.setTitle(title)` _macOS_
* `title` String
ステータスバーで、トレイアイコンのわきに表示するタイトルを設定します。
### `Tray.setHighlightMode(highlight)` _OS X_
### `Tray.setHighlightMode(highlight)` _macOS_
* `highlight` Boolean
@ -179,7 +179,7 @@ OS Xで押されたときにトレイアイコンの`image`を設定します。
トレイバルーンを表示します。
### `Tray.popUpContextMenu([menu, position])` _OS X_ _Windows_
### `Tray.popUpContextMenu([menu, position])` _macOS_ _Windows_
* `menu` Menu (optional)
* `position` Object (optional) - ポップアップ位置

View file

@ -1,9 +1,9 @@
# アプリケーションの配布
Electronでアプリケーションを配布するために、アプリケーションを`app` という名前のディレクトリにし、Electronのリソースディレクトリ(OS X では
Electronでアプリケーションを配布するために、アプリケーションを`app` という名前のディレクトリにし、Electronのリソースディレクトリ(macOS では
`Electron.app/Contents/Resources/` 、Linux と Windows では `resources/`)配下に置くべきです,
OS X:
macOS:
```text
electron/Electron.app/Contents/Resources/app/
@ -29,7 +29,7 @@ electron/resources/app
`app` フォルダの代わりに `asar` アーカイブを使用するためには、アーカイブファイルを `app.asar` という名前に変更し、Electron のリソースディレクトリに以下のように配置する必要があります。すると、Electron はアーカイブを読み込もうとし、それを開始します。
OS X:
macOS:
```text
electron/Electron.app/Contents/Resources/
@ -54,7 +54,7 @@ Electronにバンドルした後、ユーザーに配布する前に、 Electron
`electron.exe`を任意の名前に変更でき、[rcedit](https://github.com/atom/rcedit)
のようなツールでアイコンやその他の情報を編集できます。
### OS X
### macOS
`Electron.app` を任意の名前に変更でき、次のファイルの `CFBundleDisplayName``CFBundleIdentifier``CFBundleName`のフィールドの名前を変更する必要があります。

View file

@ -4,7 +4,7 @@
このガイドでは、Electron APIでデスクトップ環境にアプリケーションを統合する方法を説明します。
## 通知 (Windows, Linux, OS X)
## 通知 (Windows, Linux, macOS)
3つのオペレーティングシステム全てで、アプリケーションからユーザーに通知を送る手段が提供されています。通知を表示するためにオペレーティングシステムのネイティブ通知APIを使用しする[HTML5 Notification API](https://notifications.spec.whatwg.org/)で、Electronは、開発者に通知を送ることができます。
@ -36,15 +36,15 @@ Model ID][app-user-model-id]で、アプリへのショートカットはスタ
通知は、`libnotify`を使用して送信されます。[デスクトップ通知仕様][notification-spec]に対応したデスクトップ環境上Cinnamon、Enlightenment、Unity、GNOME、KDEなどで通知を表示できます。
### OS X
### macOS
通知は、そのままOS Xに通知されます。しかし、[通知に関するAppleのヒューマンインターフェイスガイドライン英語版](https://developer.apple.com/library/mac/documentation/UserExperience/Conceptual/OSXHIGuidelines/NotificationCenter.html)を知っておくべきです。
通知は、そのままmacOSに通知されます。しかし、[通知に関するAppleのヒューマンインターフェイスガイドライン英語版](https://developer.apple.com/library/mac/documentation/UserExperience/Conceptual/OSXHIGuidelines/NotificationCenter.html)を知っておくべきです。
通知は、256バイトサイズに制限されており、制限を超えていた場合、通知が破棄されます。
## 最近のドキュメント (Windows と OS X)
## 最近のドキュメント (Windows と macOS)
Windows と OS Xは、ジャンプリストやドックメニュー経由で、アプリケーションが開いた最近のドキュメント一覧に簡単にアクセスできます。
Windows と macOSは、ジャンプリストやドックメニュー経由で、アプリケーションが開いた最近のドキュメント一覧に簡単にアクセスできます。
__JumpList:__
@ -72,19 +72,19 @@ Windows で、この機能を使用できるようにするために、アプリ
ユーザーがジャンプリストからファイルをクリックしたとき、アプリケーションの新しいインスタンスは、コマンドライン引数にファイルのパスを渡して開始します。
### OS X 留意点
### macOS 留意点
ファイルが最近のドキュメントメニューからリクエストされた時、 `app` モジュールの `open-file` イベントが発行されます。
## ドックメニュー (OS X)のカスタマイズ
## ドックメニュー (macOS)のカスタマイズ
通常アプリケーションで使用する共通機能用のショートカットを含める、ドック用のカスタムメニューをOS Xでは指定できます。
通常アプリケーションで使用する共通機能用のショートカットを含める、ドック用のカスタムメニューをmacOSでは指定できます。
__Dock menu of Terminal.app:__
<img src="https://cloud.githubusercontent.com/assets/639601/5069962/6032658a-6e9c-11e4-9953-aa84006bdfff.png" height="354" width="341" >
カスタムドックメニューを設定するために、OS Xのみに提供されている `app.dock.setMenu` APIを使用できます。
カスタムドックメニューを設定するために、macOSのみに提供されている `app.dock.setMenu` APIを使用できます。
```javascript
const electron = require('electron');
@ -115,7 +115,7 @@ __Internet Explorerのタスク:__
![IE](http://i.msdn.microsoft.com/dynimg/IC420539.png)
実際のメニューであるOS Xのドックメニューとは異なり、ユーザーがタスクをクリックしたとき、Windowsではユーザータスクはアプリケーションのショートカットのように動作し、プログラムは指定された引数を実行します。
実際のメニューであるmacOSのドックメニューとは異なり、ユーザーがタスクをクリックしたとき、Windowsではユーザータスクはアプリケーションのショートカットのように動作し、プログラムは指定された引数を実行します。
アプリケーション用のユーザータスクを設定するために、[app.setUserTasks][setusertaskstasks] APIを使用できます:
@ -192,11 +192,11 @@ __Audaciousのランチャーショートカット:__
![audacious](https://help.ubuntu.com/community/UnityLaunchersAndDesktopFiles?action=AttachFile&do=get&target=shortcuts.png)
## タスクバーの進行状況バー (Windows, OS X, Unity)
## タスクバーの進行状況バー (Windows, macOS, Unity)
Windowsでは、タスクバーボタンは、進行状況バーを表示するのに使えます。ウィンドウを切り替えることなくウィンドウの進行状況情報をユーザーに提供することができます。
OS Xではプログレスバーはドックアイコンの一部として表示されます。
macOSではプログレスバーはドックアイコンの一部として表示されます。
Unity DEは、ランチャーに進行状況バーの表示をするのと同様の機能を持っています。
__タスクバーボタン上の進行状況バー:__
@ -227,9 +227,9 @@ let win = new BrowserWindow({...});
win.setOverlayIcon('path/to/overlay.png', 'Description for overlay');
```
## Windowのファイル表示 (OS X)
## Windowのファイル表示 (macOS)
OS Xでは、ウィンドウがrepresented fileを設定でき、タイトルバー上にファイルのアイコンを表示でき、タイトル上でCommand-クリックまたはControl-クリックをすると、パスがポップアップ表示されます。
macOSでは、ウィンドウがrepresented fileを設定でき、タイトルバー上にファイルのアイコンを表示でき、タイトル上でCommand-クリックまたはControl-クリックをすると、パスがポップアップ表示されます。
ウィンドウの編集状態を設定できるように、このウィンドウのドキュメントが変更されたかどうかをファイルのアイコンで示せます。

View file

@ -84,7 +84,7 @@ codesign -s "$APP_KEY" -f --entitlements parent.plist "$APP_PATH"
productbuild --component "$APP_PATH" /Applications --sign "$INSTALLER_KEY" "$RESULT_PATH"
```
OS Xでのアプリのサンドボックス化を行うことが初めてなら、Appleの[Enabling App Sandbox][enable-app-sandbox]を通読し、基本的な考え方を確認してから、、エンタイトルメントファイルにアプリに必要なパーミッションキーを追加します。
macOSでのアプリのサンドボックス化を行うことが初めてなら、Appleの[Enabling App Sandbox][enable-app-sandbox]を通読し、基本的な考え方を確認してから、、エンタイトルメントファイルにアプリに必要なパーミッションキーを追加します。
### Appをアップロードする。

View file

@ -86,14 +86,14 @@ app.on('ready', createWindow);
// すべてのウィンドウが閉じられた時にアプリケーションを終了する。
app.on('window-all-closed', () => {
// OS Xでは、Cmd + Q(終了)をユーザーが実行するまではウィンドウが全て閉じられても終了しないでおく。
// macOSでは、Cmd + Q(終了)をユーザーが実行するまではウィンドウが全て閉じられても終了しないでおく。
if (process.platform !== 'darwin') {
app.quit();
}
});
app.on('activate', () => {
// OS X では、ドックをクリックされた時にウィンドウがなければ新しく作成する。
// macOS では、ドックをクリックされた時にウィンドウがなければ新しく作成する。
if (win === null) {
createWindow();
}
@ -157,7 +157,7 @@ $ .\electron\electron.exe your-app\
$ ./electron/electron your-app/
```
#### OS X
#### macOS
```bash
$ ./Electron.app/Contents/MacOS/Electron your-app/

View file

@ -2,9 +2,9 @@
Electronでは次のプラットフォームをサポートします。
### OS X
### macOS
OS X用に提供しているバイナリは64bitのみで、サポートするOS Xのバージョンは、OS X 10.9 以降です。
macOS用に提供しているバイナリは64bitのみで、サポートするmacOSのバージョンは、macOS 10.9 以降です。
### Windows

View file

@ -5,7 +5,7 @@ Electronは、Pepper Flashプラグインをサポートしています。Electr
## Flash プラグインのコピー準備
OS XとLinuxでは、Pepper Flashプラグインの詳細は、Chromeブラウザーで、`chrome://plugins` にアクセスして確認できます。そこで表示されるパスとバージョンは、ElectronのPepper Flashサポートに役立ちます。それを別のパスにコピーすることができます。
macOSとLinuxでは、Pepper Flashプラグインの詳細は、Chromeブラウザーで、`chrome://plugins` にアクセスして確認できます。そこで表示されるパスとバージョンは、ElectronのPepper Flashサポートに役立ちます。それを別のパスにコピーすることができます。
## Electron スイッチの追加
@ -16,7 +16,7 @@ OS XとLinuxでは、Pepper Flashプラグインの詳細は、Chromeブラウ
```javascript
// Specify flash path.
// On Windows, it might be /path/to/pepflashplayer.dll
// On OS X, /path/to/PepperFlashPlayer.plugin
// On macOS, /path/to/PepperFlashPlayer.plugin
// On Linux, /path/to/libpepflashplayer.so
app.commandLine.appendSwitch('ppapi-flash-path', '/path/to/libpepflashplayer.so');

View file

@ -8,13 +8,13 @@ Electronは、ライセンス的な理由でWidevine CDMプラグインは同梱
__Note:__ Chromeブラウザのメジャーバージョンは、Electronが使用するChromeバージョンと同じでなければなりません。そうでなければ、プラグインは、`navigator.plugins`経由でロードされて表示されるにも関わらず動作しません。
### Windows & OS X
### Windows & macOS
Chromeブラウザーで、`chrome://components/`を開き、 `WidevineCdm` を探し、それが最新であることを確認し、`APP_DATA/Google/Chrome/WidevineCDM/VERSION/_platform_specific/PLATFORM_ARCH/`ディレクトリからすべてのプラグインバイナリを探します。
`APP_DATA` は、アプリデータを格納するシステムロケーションです。Windowsでは`%LOCALAPPDATA%`、OS Xでは`~/Library/Application Support`です。`VERSION` は、Widevine CDM プラグインのバージョン文字列で、 `1.4.8.866`のような文字列が格納されます。`PLATFORM` は、 `mac``win`です。`ARCH` は `x86``x64`です。
`APP_DATA` は、アプリデータを格納するシステムロケーションです。Windowsでは`%LOCALAPPDATA%`、macOSでは`~/Library/Application Support`です。`VERSION` は、Widevine CDM プラグインのバージョン文字列で、 `1.4.8.866`のような文字列が格納されます。`PLATFORM` は、 `mac``win`です。`ARCH` は `x86``x64`です。
Windowsでは、`widevinecdm.dll` と `widevinecdmadapter.dll`が必要で、OS Xでは、`libwidevinecdm.dylib` と `widevinecdmadapter.plugin`です。任意の場所にコピーできますが、一緒に配置する必要があります。
Windowsでは、`widevinecdm.dll` と `widevinecdmadapter.dll`が必要で、macOSでは、`libwidevinecdm.dylib` と `widevinecdmadapter.plugin`です。任意の場所にコピーできますが、一緒に配置する必要があります。
### Linux
@ -32,7 +32,7 @@ __Note:__ `widevinecdmadapter` バイナリはElectronにパスが通ってい
```javascript
// You have to pass the filename of `widevinecdmadapter` here, it is
// * `widevinecdmadapter.plugin` on OS X,
// * `widevinecdmadapter.plugin` on macOS,
// * `libwidevinecdmadapter.so` on Linux,
// * `widevinecdmadapter.dll` on Windows.
app.commandLine.appendSwitch('widevine-cdm-path', '/path/to/widevinecdmadapter.plugin');

View file

@ -93,7 +93,7 @@ Electron에 대해 자주 묻는 질문이 있습니다. 이슈를 생성하기
* [소스 코드 디렉터리 구조](development/source-code-directory-structure.md)
* [NW.js(node-webkit)와 기술적으로 다른점](development/atom-shell-vs-node-webkit.md)
* [빌드 시스템 개요](development/build-system-overview.md)
* [빌드 설명서 (OS X)](development/build-instructions-osx.md)
* [빌드 설명서 (macOS)](development/build-instructions-osx.md)
* [빌드 설명서 (Windows)](development/build-instructions-windows.md)
* [빌드 설명서 (Linux)](development/build-instructions-linux.md)
* [디버그 설명서 (Windows)](development/debug-instructions-windows.md)

View file

@ -12,13 +12,13 @@ Accelerator는 `+` 문자를 통해 여러 혼합키와 키코드를 결합할
## 플랫폼에 관련하여 주의할 점
Linux와 Windows에서는 `Command`키가 없으므로 작동하지 않습니다. 대신에
`CommandOrControl`을 사용하면 OS X`Command`와 Linux, Windows의 `Control` 모두
`CommandOrControl`을 사용하면 macOS의 `Command`와 Linux, Windows의 `Control` 모두
지원할 수 있습니다.
`Option` 대신 `Alt`을 사용하는게 좋습니다. `Option` 키는 OS X에만 있으므로
`Option` 대신 `Alt`을 사용하는게 좋습니다. `Option` 키는 macOS에만 있으므로
모든 플랫폼에서 사용할 수 있는 `Alt` 키를 권장합니다.
`Super`키는 Windows와 Linux 에서는 `윈도우`키를, OS X에서는 `Cmd`키로 맵핑됩니다.
`Super`키는 Windows와 Linux 에서는 `윈도우`키를, macOS에서는 `Cmd`키로 맵핑됩니다.
## 사용 가능한 혼합키

View file

@ -19,7 +19,7 @@ app.on('window-all-closed', () => {
애플리케이션이 기본적인 시작 준비를 마치면 발생하는 이벤트입니다.
Windows, Linux 운영체제에서의 `will-finish-launching` 이벤트는 `ready` 이벤트와
동일합니다. OS X에서의 이벤트는 `NSApplication`
동일합니다. macOS에서의 이벤트는 `NSApplication`
`applicationWillFinishLaunching`에 대한 알림으로 표현됩니다. 대개 이곳에서
`open-file``open-url` 이벤트 리스너를 설정하고 crash reporter와 auto updater를
시작합니다.
@ -76,7 +76,7 @@ Returns:
애플리케이션이 종료될 때 발생하는 이벤트입니다.
### Event: 'open-file' _OS X_
### Event: 'open-file' _macOS_
Returns:
@ -95,7 +95,7 @@ Returns:
Windows에선 `process.argv` (메인 프로세스에서)를 통해 파일 경로를 얻을 수 있습니다.
### Event: 'open-url' _OS X_
### Event: 'open-url' _macOS_
Returns:
@ -108,7 +108,7 @@ Returns:
이 이벤트를 처리할 땐 반드시 `event.preventDefault()`를 호출해야 합니다.
### Event: 'activate' _OS X_
### Event: 'activate' _macOS_
Returns:
@ -118,7 +118,7 @@ Returns:
애플리케이션이 활성화 되었을 때 발생하는 이벤트입니다. 이 이벤트는 사용자가
애플리케이션의 dock 아이콘을 클릭했을 때 주로 발생합니다.
### Event: 'continue-activity' _OS X_
### Event: 'continue-activity' _macOS_
Returns:
@ -308,14 +308,14 @@ app.exit(0)
### `app.focus()`
Linux에선, 첫 번째로 보여지는 윈도우가 포커스됩니다. OS X에선, 애플리케이션을 활성화
Linux에선, 첫 번째로 보여지는 윈도우가 포커스됩니다. macOS에선, 애플리케이션을 활성화
앱 상태로 만듭니다. Windows에선, 애플리케이션의 첫 윈도우에 포커스 됩니다.
### `app.hide()` _OS X_
### `app.hide()` _macOS_
최소화를 하지 않고 애플리케이션의 모든 윈도우들을 숨깁니다.
### `app.show()` _OS X_
### `app.show()` _macOS_
숨긴 애플리케이션 윈도우들을 다시 보이게 만듭니다. 자동으로 포커스되지 않습니다.
@ -338,7 +338,7 @@ Linux에선, 첫 번째로 보여지는 윈도우가 포커스됩니다. OS X에
* `appData` - 각 사용자의 애플리케이션 데이터 디렉터리. 기본 경로는 다음과 같습니다:
* `%APPDATA%` - Windows
* `$XDG_CONFIG_HOME` 또는 `~/.config` - Linux
* `~/Library/Application Support` - OS X
* `~/Library/Application Support` - macOS
* `userData` - 애플리케이션의 설정을 저장하는 디렉터리.
이 디렉터리는 기본적으로 `appData`에 애플리케이션 이름으로 생성된 폴더가 지정됩니다.
* `temp` - 임시 폴더 디렉터리.
@ -399,20 +399,20 @@ npm 모듈 규칙에 따라 대부분의 경우 `package.json`의 `name` 필드
**참고:** Windows에선 `ready` 이벤트가 발생한 이후에 이 메서드를 호출해야 합니다.
### `app.addRecentDocument(path)` _OS X_ _Windows_
### `app.addRecentDocument(path)` _macOS_ _Windows_
* `path` String
최근 문서 목록에 `path`를 추가합니다.
이 목록은 OS에 의해 관리됩니다. 최근 문서 목록은 Windows의 경우 작업 표시줄에서 찾을
수 있고, OS X의 경우 dock 메뉴에서 찾을 수 있습니다.
수 있고, macOS의 경우 dock 메뉴에서 찾을 수 있습니다.
### `app.clearRecentDocuments()` _OS X_ _Windows_
### `app.clearRecentDocuments()` _macOS_ _Windows_
최근 문서 목록을 모두 비웁니다.
### `app.setAsDefaultProtocolClient(protocol)` _OS X_ _Windows_
### `app.setAsDefaultProtocolClient(protocol)` _macOS_ _Windows_
* `protocol` String - 프로토콜의 이름, `://` 제외. 만약 앱을 통해 `electron://`
같은 링크를 처리하고 싶다면, 이 메서드에 `electron` 인수를 담아 호출하면 됩니다.
@ -422,29 +422,29 @@ npm 모듈 규칙에 따라 대부분의 경우 `package.json`의 `name` 필드
`your-protocol://`과 같은 모든 링크에 대해 호출시 현재 실행 파일이 실행됩니다.
모든 링크, 프로토콜을 포함하여 애플리케이션의 인수로 전달됩니다.
**참고:** OS X에선, 애플리케이션의 `info.plist`에 등록해둔 프로토콜만 사용할 수
**참고:** macOS에선, 애플리케이션의 `info.plist`에 등록해둔 프로토콜만 사용할 수
있습니다. 이는 런타임에서 변경될 수 없습니다. 이 파일은 간단히 텍스트 에디터를
사용하거나, 애플리케이션을 빌드할 때 스크립트가 생성되도록 할 수 있습니다. 자세한
내용은 [Apple의 참조 문서][CFBundleURLTypes]를 확인하세요.
이 API는 내부적으로 Windows 레지스트리와 LSSetDefaultHandlerForURLScheme를 사용합니다.
### `app.removeAsDefaultProtocolClient(protocol)` _OS X_ _Windows_
### `app.removeAsDefaultProtocolClient(protocol)` _macOS_ _Windows_
* `protocol` String - 프로토콜의 이름, `://` 제외.
이 메서드는 현재 실행파일이 지정한 프로토콜(URI scheme)에 대해 기본 핸들러인지를
확인합니다. 만약 그렇다면, 이 메서드는 앱을 기본 핸들러에서 제거합니다.
### `app.isDefaultProtocolClient(protocol)` _OS X_ _Windows_
### `app.isDefaultProtocolClient(protocol)` _macOS_ _Windows_
* `protocol` String - `://`를 제외한 프로토콜의 이름.
이 메서드는 현재 실행 파일이 지정한 프로토콜에 대해 기본 동작인지 확인합니다. (URI
스킴) 만약 그렇다면 `true`를 반환하고 아닌 경우 `false`를 반환합니다.
**참고:** OS X에선, 응용 프로그램이 프로토콜에 대한 기본 프로토콜 동작으로
등록되었는지를 확인하기 위해 이 메서드를 사용할 수 있습니다. 또한 OS X에서
**참고:** macOS에선, 응용 프로그램이 프로토콜에 대한 기본 프로토콜 동작으로
등록되었는지를 확인하기 위해 이 메서드를 사용할 수 있습니다. 또한 macOS에서
`~/Library/Preferences/com.apple.LaunchServices.plist`를 확인하여 검증할 수도
있습니다. 자세한 내용은 [Apple의 참조 문서][LSCopyDefaultHandlerForURLScheme]를
참고하세요.
@ -494,10 +494,10 @@ Windows에서 사용할 수 있는 JumpList의 [Tasks][tasks] 카테고리에 `t
경우 `true`를 반환합니다. (다른 인스턴스에 인수가 전달됬을 때) 이 불리언 값을 통해
중복 생성된 인스턴스는 즉시 종료시켜야 합니다.
OS X에선 사용자가 Finder에서 애플리케이션의 두 번째 인스턴스를 열려고 했을 때 자동으로
macOS에선 사용자가 Finder에서 애플리케이션의 두 번째 인스턴스를 열려고 했을 때 자동으로
**Single Instance** 화 하고 `open-file``open-url` 이벤트를 발생시킵니다. 그러나
사용자가 애플리케이션을 CLI 터미널에서 실행하면 운영체제 시스템의 싱글 인스턴스
메커니즘이 무시되며 그대로 중복 실행됩니다. 따라서 OS X에서도 이 메서드를 통해 확실히
메커니즘이 무시되며 그대로 중복 실행됩니다. 따라서 macOS에서도 이 메서드를 통해 확실히
중복 실행을 방지하는 것이 좋습니다.
다음 예시는 두 번째 인스턴스가 생성되었을 때 중복된 인스턴스를 종료하고 주 애플리케이션
@ -530,7 +530,7 @@ app.on('ready', () => {
모든 `makeSingleInstance`에 의해 생성된 제한을 해제합니다. 이 메서드는 다시 여러
인스턴스의 애플리케이션이 나란히 실행될 수 있도록 합니다.
### `app.setUserActivity(type, userInfo[, webpageURL])` _OS X_
### `app.setUserActivity(type, userInfo[, webpageURL])` _macOS_
* `type` String - 고유하게 activity를 식별합니다.
[`NSUserActivity.activityType`][activity-type]을 맵핑합니다.
@ -541,7 +541,7 @@ app.on('ready', () => {
`NSUserActivity`를 만들고 현재 activity에 설정합니다. 이 activity는 이후 다른 기기와
[Handoff][handoff]할 때 자격으로 사용됩니다.
### `app.getCurrentActivityType()` _OS X_
### `app.getCurrentActivityType()` _macOS_
현재 작동중인 activity의 타입을 반환합니다.
@ -583,7 +583,7 @@ Chrominum의 명령줄에 인수를 추가합니다. 인수는 올바르게 인
**참고:** 이 메서드는 `process.argv`에 영향을 주지 않습니다.
### `app.dock.bounce([type])` _OS X_
### `app.dock.bounce([type])` _macOS_
* `type` String (optional) - `critical` 또는 `informational`을 지정할 수 있습니다.
기본값은 `informational` 입니다.
@ -596,43 +596,43 @@ Chrominum의 명령줄에 인수를 추가합니다. 인수는 올바르게 인
또한 요청을 취소할 때 사용할 수 있는 ID를 반환합니다.
### `app.dock.cancelBounce(id)` _OS X_
### `app.dock.cancelBounce(id)` _macOS_
* `id` Integer
`app.dock.bounce([type])` 메서드에서 반환한 `id`의 바운스 효과를 취소합니다.
### `app.dock.downloadFinished(filePath)` _OS X_
### `app.dock.downloadFinished(filePath)` _macOS_
* `filePath` String
`filePath`가 다운로드 폴더에 들어있다면 다운로드 스택을 바운스합니다.
### `app.dock.setBadge(text)` _OS X_
### `app.dock.setBadge(text)` _macOS_
* `text` String
dock의 badge에 표시할 문자열을 설정합니다.
### `app.dock.getBadge()` _OS X_
### `app.dock.getBadge()` _macOS_
dock의 badge에 설정된 문자열을 반환합니다.
### `app.dock.hide()` _OS X_
### `app.dock.hide()` _macOS_
dock 아이콘을 숨깁니다.
### `app.dock.show()` _OS X_
### `app.dock.show()` _macOS_
dock 아이콘을 표시합니다.
### `app.dock.setMenu(menu)` _OS X_
### `app.dock.setMenu(menu)` _macOS_
* `menu` [Menu](menu.md)
애플리케이션의 [dock menu][dock-menu]를 설정합니다.
### `app.dock.setIcon(image)` _OS X_
### `app.dock.setIcon(image)` _macOS_
* `image` [NativeImage](native-image.md)

View file

@ -21,13 +21,13 @@ Squirrel.Mac 와 Squirrel.Windows를 위한 간단한 node.js 기반 서버입
`autoUpdater`는 기본적으로 모든 플랫폼에 대해 같은 API를 제공하지만, 여전히 플랫폼별로
약간씩 다른 점이 있습니다.
### OS X
### macOS
OS X에선 `auto-updater` 모듈이 [Squirrel.Mac][squirrel-mac]를 기반으로 작동합니다.
macOS에선 `auto-updater` 모듈이 [Squirrel.Mac][squirrel-mac]를 기반으로 작동합니다.
따라서 이 모듈을 작동시키기 위해 특별히 준비해야 할 작업은 없습니다.
서버 사이드 요구 사항은 [서버 지원][server-support]을 참고하세요.
**참고:** Mac OS X에서 자동 업데이트를 지원하려면 반드시 사인이 되어있어야 합니다.
**참고:** macOS에서 자동 업데이트를 지원하려면 반드시 사인이 되어있어야 합니다.
이것은 `Squirrel.Mac`의 요구 사항입니다.
### Windows
@ -47,7 +47,7 @@ Squirrel로 생성된 인스톨러는 [Application User Model ID][app-user-model
`app.setAppUserModelId` API를 통해 애플리케이션 ID를 동일하게 유지해야 합니다. 그렇지
않으면 Windows 작업 표시줄에 애플리케이션을 고정할 때 제대로 적용되지 않을 수 있습니다.
서버 사이드 요구 사항 또한 OS X와 다르게 적용됩니다. 자세한 내용은
서버 사이드 요구 사항 또한 macOS와 다르게 적용됩니다. 자세한 내용은
[Squirrel.Windows][squirrel-windows]를 참고하세요.
### Linux
@ -98,7 +98,7 @@ Returns:
### `autoUpdater.setFeedURL(url[, requestHeaders])`
* `url` String
* `requestHeaders` Object _OS X_ - HTTP 요청 헤더.
* `requestHeaders` Object _macOS_ - HTTP 요청 헤더.
`url`을 설정하고 자동 업데이터를 초기화합니다.

View file

@ -61,10 +61,10 @@ win.show();
* `alwaysOnTop` Boolean - 윈도우이 언제나 다른 창들 위에 유지되는지 여부.
기본값은 `false`입니다.
* `fullscreen` Boolean - 윈도우의 전체화면 활성화 여부. 이 속성을 명시적으로
`false`로 지정했을 경우, OS X에선 전체화면 버튼이 숨겨지거나 비활성됩니다. 기본값은
`false`로 지정했을 경우, macOS에선 전체화면 버튼이 숨겨지거나 비활성됩니다. 기본값은
`false` 입니다.
* `fullscreenable` Boolean - 윈도우가 전체화면 모드로 전환될 수 있는지 여부입니다.
또한 OS X에선, 최대화/줌 버튼이 전체화면 모드 또는 윈도우 최대화를 실행할지 여부도
또한 macOS에선, 최대화/줌 버튼이 전체화면 모드 또는 윈도우 최대화를 실행할지 여부도
포함됩니다. 기본값은 `true`입니다.
* `skipTaskbar` Boolean - 작업표시줄 애플리케이션 아이콘 표시 스킵 여부. 기본값은
`false`입니다.
@ -92,16 +92,16 @@ On Windows it is
* `backgroundColor` String - `#66CD00``#FFF`, `#80FFFFFF` (알파 지원됨) 같이
16진수로 표현된 윈도우의 배경 색. 기본값은 `#FFF` (white).
* `hasShadow` Boolean - 윈도우가 그림자를 가질지 여부를 지정합니다. 이 속성은
OS X에서만 구현되어 있습니다. 기본값은 `true`입니다.
macOS에서만 구현되어 있습니다. 기본값은 `true`입니다.
* `darkTheme` Boolean - 설정에 상관 없이 무조건 어두운 윈도우 테마를 사용합니다.
몇몇 GTK+3 데스크톱 환경에서만 작동합니다. 기본값은 `false`입니다.
* `transparent` Boolean - 윈도우를 [투명화](frameless-window.md)합니다. 기본값은
`false`입니다.
* `type` String - 특정 플랫폼에만 적용되는 윈도우의 종류를 지정합니다. 기본값은
일반 윈도우 입니다. 사용할 수 있는 창의 종류는 아래를 참고하세요.
* `standardWindow` Boolean - OS X의 표준 윈도우를 텍스쳐 윈도우 대신 사용합니다.
* `standardWindow` Boolean - macOS의 표준 윈도우를 텍스쳐 윈도우 대신 사용합니다.
기본 값은 `true`입니다.
* `titleBarStyle` String, OS X - 윈도우 타이틀 바 스타일을 지정합니다. 자세한 사항은
* `titleBarStyle` String, macOS - 윈도우 타이틀 바 스타일을 지정합니다. 자세한 사항은
아래를 참고하세요.
* `webPreferences` Object - 웹 페이지 기능을 설정합니다. 사용할 수 있는 속성은
아래를 참고하세요.
@ -114,14 +114,14 @@ On Windows it is
* Linux의 경우, `desktop`, `dock`, `toolbar`, `splash`, `notification` 종류를
사용할 수 있습니다.
* OS X의 경우, `desktop`, `textured` 종류를 사용할 수 있습니다.
* macOS의 경우, `desktop`, `textured` 종류를 사용할 수 있습니다.
* `textured`는 창에 메탈 그라디언트 외관(`NSTexturedBackgroundWindowMask`)을
설정합니다.
* `desktop`은 데스크탑 배경 레벨(`kCGDesktopWindowLevel - 1`)에 윈도우를
배치합니다. 참고로 이렇게 만들어진 윈도우는 포커스, 키보드, 마우스 이벤트를 받을
수 없습니다. 하지만 편법으로 `globalShortcut`을 통해 키 입력을 받을 수 있습니다.
`titleBarStyle` 속성은 OS X 10.10 Yosemite 이후 버전만 지원하며, 다음 3가지 종류의
`titleBarStyle` 속성은 macOS 10.10 Yosemite 이후 버전만 지원하며, 다음 3가지 종류의
값을 사용할 수 있습니다:
* `default` 또는 미지정: 표준 Mac 회색 불투명 스타일을 사용합니다.
@ -174,7 +174,7 @@ On Windows it is
활성화합니다. 기본값은 `false`입니다.
* `directWrite` Boolean - Windows에서 폰트 렌더링을 위해 DirectWrite를
사용하는지를 지정합니다. 기본값은 `true`입니다.
* `scrollBounce` Boolean - OS X에서 스크롤 튕기기 효과 (탄성 밴딩)를 활성화 합니다.
* `scrollBounce` Boolean - macOS에서 스크롤 튕기기 효과 (탄성 밴딩)를 활성화 합니다.
기본값은 `false`입니다.
* `blinkFeatures` String - 활성화 할 `CSSVariables,KeyboardEventKey`같이 `,`
구분된 기능 문자열들의 리스트입니다. [RuntimeEnabledFeatures.in][blink-feature-string]
@ -289,9 +289,9 @@ window.onbeforeunload = (e) => {
윈도우가 새로운 위치로 이동될 때 발생하는 이벤트입니다.
__참고__: OS X에선 이 이벤트가 그저 `moved` 이벤트의 별칭(alias)으로 사용됩니다.
__참고__: macOS에선 이 이벤트가 그저 `moved` 이벤트의 별칭(alias)으로 사용됩니다.
### Event: 'moved' _OS X_
### Event: 'moved' _macOS_
윈도우가 새로운 위치로 이동되었을 때 발생하는 이벤트입니다. (한 번만)
@ -336,15 +336,15 @@ someWindow.on('app-command', (e, cmd) => {
});
```
### Event: 'scroll-touch-begin' _OS X_
### Event: 'scroll-touch-begin' _macOS_
스크롤 휠 이벤트가 동작하기 시작했을 때 발생하는 이벤트입니다.
### Event: 'scroll-touch-end' _OS X_
### Event: 'scroll-touch-end' _macOS_
스크롤 휠 이벤트가 동작을 멈췄을 때 발생하는 이벤트입니다.
### Event: 'swipe' _OS X_
### Event: 'swipe' _macOS_
Returns:
@ -507,7 +507,7 @@ let win = new BrowserWindow({width: 800, height: 600});
윈도우가 전체화면 모드 상태인지 여부를 반환합니다.
### `win.setAspectRatio(aspectRatio[, extraSize])` _OS X_
### `win.setAspectRatio(aspectRatio[, extraSize])` _macOS_
* `aspectRatio` 유지하려 하는 콘텐츠 뷰 일부의 종횡비
* `extraSize` Object (optional) - 종횡비를 유지하는 동안 포함되지 않을 엑스트라 크기.
@ -535,7 +535,7 @@ let win = new BrowserWindow({width: 800, height: 600});
* `width` Integer
* `height` Integer
* `animate` Boolean (optional) _OS X_
* `animate` Boolean (optional) _macOS_
윈도우를 지정한 `width`, `height`, `x`, `y`로 크기 재조정 및 이동합니다.
@ -547,7 +547,7 @@ let win = new BrowserWindow({width: 800, height: 600});
* `width` Integer
* `height` Integer
* `animate` Boolean (optional) _OS X_
* `animate` Boolean (optional) _macOS_
`width``height` 값으로 윈도우 크기를 재조정합니다. (너비, 높이)
@ -559,7 +559,7 @@ let win = new BrowserWindow({width: 800, height: 600});
* `width` Integer
* `height` Integer
* `animate` Boolean (optional) _OS X_
* `animate` Boolean (optional) _macOS_
윈도우 클라이언트 영역(웹 페이지)의 크기를 `width`, `height`로 재조정합니다.
@ -599,38 +599,38 @@ let win = new BrowserWindow({width: 800, height: 600});
사용자에 의해 윈도우의 크기가 재조정될 수 있는지 여부를 반환합니다.
### `win.setMovable(movable)` _OS X_ _Windows_
### `win.setMovable(movable)` _macOS_ _Windows_
* `movable` Boolean
사용자에 의해 윈도우를 이동시킬 수 있는지 여부를 지정합니다. Linux에선 아무 일도
일어나지 않습니다.
### `win.isMovable()` _OS X_ _Windows_
### `win.isMovable()` _macOS_ _Windows_
사용자에 의해 윈도우를 이동시킬 수 있는지 여부를 반환합니다. Linux에선 항상 `true`
반환합니다.
### `win.setMinimizable(minimizable)` _OS X_ _Windows_
### `win.setMinimizable(minimizable)` _macOS_ _Windows_
* `minimizable` Boolean
사용자에 의해 윈도우를 최소화시킬 수 있는지 여부를 지정합니다. Linux에선 아무 일도
일어나지 않습니다.
### `win.isMinimizable()` _OS X_ _Windows_
### `win.isMinimizable()` _macOS_ _Windows_
사용자에 의해 윈도우를 최소화시킬 수 있는지 여부를 반환합니다. Linux에선 항상 `true`
반환합니다.
### `win.setMaximizable(maximizable)` _OS X_ _Windows_
### `win.setMaximizable(maximizable)` _macOS_ _Windows_
* `maximizable` Boolean
사용자에 의해 윈도우를 최대화시킬 수 있는지 여부를 지정합니다. Linux에선 아무 일도
일어나지 않습니다.
### `win.isMaximizable()` _OS X_ _Windows_
### `win.isMaximizable()` _macOS_ _Windows_
사용자에 의해 윈도우를 최대화시킬 수 있는지 여부를 반환합니다. Linux에선 항상 `true`
반환합니다.
@ -647,14 +647,14 @@ let win = new BrowserWindow({width: 800, height: 600});
최대화/줌 버튼이 전체화면 모드 또는 윈도우 최대화를 토글할 수 있게 할지 여부를
반환합니다.
### `win.setClosable(closable)` _OS X_ _Windows_
### `win.setClosable(closable)` _macOS_ _Windows_
* `closable` Boolean
사용자에 의해 윈도우가 수동적으로 닫힐 수 있는지 여부를 지정합니다. Linux에선 아무 일도
일어나지 않습니다.
### `win.isClosable()` _OS X_ _Windows_
### `win.isClosable()` _macOS_ _Windows_
사용자에 의해 윈도우가 수동적으로 닫힐 수 있는지 여부를 반환합니다. Linux에선 항상
`true`를 반환합니다.
@ -678,7 +678,7 @@ let win = new BrowserWindow({width: 800, height: 600});
* `x` Integer
* `y` Integer
* `animate` Boolean (optional) _OS X_
* `animate` Boolean (optional) _macOS_
윈도우의 위치를 `x`, `y`로 이동합니다.
@ -698,9 +698,9 @@ let win = new BrowserWindow({width: 800, height: 600});
**참고:** 웹 페이지의 제목과 네이티브 윈도우의 제목은 서로 다를 수 있습니다.
### `win.setSheetOffset(offsetY[, offsetX])` _OS X_
### `win.setSheetOffset(offsetY[, offsetX])` _macOS_
Mac OS X에서 시트를 부착할 위치를 지정합니다. 기본적으로 시트는 윈도우의 프레임 바로
macOS에서 시트를 부착할 위치를 지정합니다. 기본적으로 시트는 윈도우의 프레임 바로
아래의 위치에 부착됩니다. 아마도 이 기능은 보통 다음과 같이 HTML 렌더링된 툴바 밑에
표시하기 위해 사용할 것입니다:
@ -735,7 +735,7 @@ Kiosk(키오스크) 모드를 설정합니다.
`Buffer` 상의 플랫폼에 따른 윈도우 핸들을 반환합니다.
핸들의 타입에 따라 적절히 캐스팅됩니다. Windows의 `HWND`, OS X`NSView*`, Linux의
핸들의 타입에 따라 적절히 캐스팅됩니다. Windows의 `HWND`, macOS의 `NSView*`, Linux의
`Window` (`unsigned long`)를 예로 들 수 있습니다.
### `win.hookWindowMessage(message, callback)` _Windows_
@ -762,24 +762,24 @@ Windows 메시지 훅을 등록합니다. `callback`은 WndProc에서 메시지
모든 메시지 훅을 등록 해제합니다.
### `win.setRepresentedFilename(filename)` _OS X_
### `win.setRepresentedFilename(filename)` _macOS_
* `filename` String
윈도우 대표 파일의 경로명을 설정합니다. 파일의 아이콘이 윈도우 타이틀 바에 표시됩니다.
### `win.getRepresentedFilename()` _OS X_
### `win.getRepresentedFilename()` _macOS_
윈도우 대표 파일의 경로명을 반환합니다.
### `win.setDocumentEdited(edited)` _OS X_
### `win.setDocumentEdited(edited)` _macOS_
* `edited` Boolean
윈도우의 문서가 변경되었는지 여부를 설정합니다. 그리고 `true`로 설정했을 때 타이틀 바의
아이콘이 회색으로 표시됩니다.
### `win.isDocumentEdited()` _OS X_
### `win.isDocumentEdited()` _macOS_
윈도우의 문서가 변경되었는지 여부를 반환합니다.
@ -837,14 +837,14 @@ Linux 플랫폼에선 Unity 데스크톱 환경만 지원합니다. 그리고
현재 작업표시줄 아이콘에 16 x 16 픽셀 크기의 오버레이를 지정합니다. 보통 이 기능은
애플리케이션의 여러 상태를 사용자에게 소극적으로 알리기 위한 방법으로 사용됩니다.
### `win.setHasShadow(hasShadow)` _OS X_
### `win.setHasShadow(hasShadow)` _macOS_
* `hasShadow` (Boolean)
윈도우가 그림자를 가질지 여부를 지정합니다. Windows와 Linux에선 아무 일도 일어나지
않습니다.
### `win.hasShadow()` _OS X_
### `win.hasShadow()` _macOS_
윈도우가 그림자를 가지고 있는지 여부를 반환합니다. Windows와 Linux에선 항상 `true`
반환합니다.
@ -879,7 +879,7 @@ Linux 플랫폼에선 Unity 데스크톱 환경만 지원합니다. 그리고
눌려지지 않은 상태를 유지합니다. 이 값은 버튼을 알림의 용도로 사용하기 위해
만들어졌습니다.
### `win.showDefinitionForSelection()` _OS X_
### `win.showDefinitionForSelection()` _macOS_
`webContents.showDefinitionForSelection()`와 같습니다.

View file

@ -39,7 +39,7 @@ crashReporter.start({
다른 crashReporter API를 사용하기 전에 이 메서드를 먼저 호출해야 합니다.
**참고:** OS X에선 Windows와 Linux의 `breakpad`와 달리 새로운 `crashpad`
**참고:** macOS에선 Windows와 Linux의 `breakpad`와 달리 새로운 `crashpad`
클라이언트를 사용합니다. 오류 수집 기능을 활성화 시키려면 오류를 수집하고 싶은 메인
프로세스나 렌더러 프로세스에서 `crashReporter.start` 메서드를 호출하여 `crashpad`
초기화해야 합니다.

View file

@ -105,7 +105,7 @@ const {dialog} = require('electron').remote;
* `cancelId` Integer - 유저가 대화 상자의 버튼을 클릭하지 않고 대화 상자를 취소했을
때 반환되는 버튼의 인덱스입니다. 기본적으로 버튼 리스트가 "cancel" 또는 "no"
라벨을 가지고 있을 때 해당 버튼의 인덱스를 반환합니다. 따로 두 라벨이 지정되지
않은 경우 0을 반환합니다. OS X와 Windows에선 `cancelId` 지정 여부에 상관없이
않은 경우 0을 반환합니다. macOS와 Windows에선 `cancelId` 지정 여부에 상관없이
"Cancel" 버튼이 언제나 `cancelId`로 지정됩니다.
* `noLink` Boolean - Windows에서 Electron은 ("Cancel"이나 "Yes"와 같은) 흔히
사용되는 버튼을 찾으려고 시도하고 대화 상자 내에서 해당 버튼을 커맨드 링크처럼
@ -117,7 +117,7 @@ const {dialog} = require('electron').remote;
지정한 창을 사용할 수 없습니다. 완료 시 유저가 선택한 버튼의 인덱스를 반환합니다.
**역자주:** 부정을 표현하는 "아니오", "취소"와 같은 한글 단어는 지원되지 않습니다. 만약
OS X 또는 Windows에서 "확인", "취소"와 같은 순서로 버튼을 지정하게 될 때 Alt + f4로
macOS 또는 Windows에서 "확인", "취소"와 같은 순서로 버튼을 지정하게 될 때 Alt + f4로
해당 대화 상자를 끄게 되면 "확인"을 누른 것으로 판단되어 버립니다. 이를 해결하려면
"Cancel"을 대신 사용하거나 BrowserWindow API를 사용하여 대화 상자를 직접 구현해야
합니다.
@ -136,7 +136,7 @@ Linux에서 `ready` 이벤트가 발생하기 전에 이 API를 호출할 경우
## Sheets
Mac OS X에선, `browserWindow` 인수에 `BrowserWindow` 객체 참조를 전달하면 대화
macOS에선, `browserWindow` 인수에 `BrowserWindow` 객체 참조를 전달하면 대화
상자가 해당 윈도우에 시트처럼 표시되도록 표현할 수 있습니다. 윈도우의 객체 참조가
제공되지 않으면 모달 형태로 표시됩니다.

View file

@ -17,9 +17,9 @@ const {BrowserWindow} = require('electron')
let win = new BrowserWindow({width: 800, height: 600, frame: false})
```
### 최신 OS X에서 사용할 수 있는 대안
### 최신 macOS에서 사용할 수 있는 대안
OS X 10.10 Yosemite 이후의 최신 버전부터는 테두리가 없는 창을 만들 때 새로운 방법을
macOS 10.10 Yosemite 이후의 최신 버전부터는 테두리가 없는 창을 만들 때 새로운 방법을
사용할 수 있습니다. `frame` 옵션을 `false`로 지정하여 제목과 창 구성 요소를 모두
비활성화하는 대신 새로운 `titleBarStyle` 옵션을 통해 제목만 숨기고 창 구성 요소
("신호등 버튼")의 기능과 창 크기를 그대로 유지할 수 있습니다:
@ -52,7 +52,7 @@ let win = new BrowserWindow({transparent: true, frame: false})
upstream 버그가 있는 관계로 투명한 창 기능을 사용하려면 CLI 옵션에
`--enable-transparent-visuals --disable-gpu`을 추가해야 합니다. 이 옵션은 GPU의
사용을 중단하고 윈도우를 생성하는데 ARGB를 사용할 수 있도록 해줍니다.
* OS X(Mac)에선 네이티브 창에서 보여지는 그림자가 투명한 창에선 보이지 않습니다.
* macOS(Mac)에선 네이티브 창에서 보여지는 그림자가 투명한 창에선 보이지 않습니다.
## 클릭이 통과될 수 있는 윈도우

View file

@ -52,7 +52,7 @@
* `minimize` - 현재 윈도우를 최소화합니다
* `close` - 현재 윈도우를 닫습니다
OS X에서의 `role`은 다음 값을 추가로 가질 수 있습니다:
macOS에서의 `role`은 다음 값을 추가로 가질 수 있습니다:
* `about` - `orderFrontStandardAboutPanel` 액션에 대응
* `hide` - `hide` 액션에 대응
@ -63,7 +63,7 @@ OS X에서의 `role`은 다음 값을 추가로 가질 수 있습니다:
* `help` - 부 메뉴를 가지는 "Help" 메뉴
* `services` - 부 메뉴를 가지는 "Services" 메뉴
OS X에서는 `role`을 지정할 때, `label``accelerator`만 MenuItem에 효과가
macOS에서는 `role`을 지정할 때, `label``accelerator`만 MenuItem에 효과가
적용되도록 변경되며, 다른 옵션들은 모두 무시됩니다.
## Instance Properties

View file

@ -202,20 +202,20 @@ Menu.setApplicationMenu(menu);
* `menu` Menu
지정한 `menu`를 애플리케이션 메뉴로 만듭니다. OS X에선 상단바에 표시되며 Windows와
지정한 `menu`를 애플리케이션 메뉴로 만듭니다. macOS에선 상단바에 표시되며 Windows와
Linux에선 각 창의 상단에 표시됩니다.
**참고** 이 API는 `app``ready` 이벤트가 발생한 이후에 호출해야 합니다.
### `Menu.sendActionToFirstResponder(action)` _OS X_
### `Menu.sendActionToFirstResponder(action)` _macOS_
* `action` String
`action`을 애플리케이션의 first responder에 전달합니다. 이 메서드는 Cocoa 메뉴
동작을 에뮬레이트 하는데 사용되며 보통 `MenuItem``role` 속성에 사용됩니다.
OS X의 네이티브 액션에 대해 자세히 알아보려면
[OS X Cocoa Event Handling Guide](https://developer.apple.com/library/mac/documentation/Cocoa/Conceptual/EventOverview/EventArchitecture/EventArchitecture.html#//apple_ref/doc/uid/10000060i-CH3-SW7)
macOS의 네이티브 액션에 대해 자세히 알아보려면
[macOS Cocoa Event Handling Guide](https://developer.apple.com/library/mac/documentation/Cocoa/Conceptual/EventOverview/EventArchitecture/EventArchitecture.html#//apple_ref/doc/uid/10000060i-CH3-SW7)
문서를 참고하세요.
### `Menu.buildFromTemplate(template)`
@ -237,13 +237,13 @@ OS X의 네이티브 액션에 대해 자세히 알아보려면
* `browserWindow` BrowserWindow (optional) - 기본값은 `null`입니다.
* `x` Number (optional) - 기본값은 -1입니다.
* `y` Number (만약 `x`를 지정한 경우 **필수 항목**) - 기본값은 -1입니다.
* `positioningItem` Number (optional) _OS X_ - 메뉴 팝업 시 마우스 커서에 바로
* `positioningItem` Number (optional) _macOS_ - 메뉴 팝업 시 마우스 커서에 바로
위치시킬 메뉴 아이템의 인덱스. 기본값은 -1입니다.
메뉴를 `browserWindow` 내부 팝업으로 표시합니다. 옵션으로 메뉴를 표시할 `(x,y)`
좌표를 지정할 수 있습니다. 따로 좌표를 지정하지 않은 경우 마우스 커서 위치에 표시됩니다.
`positioningItem` 속성은 메뉴 팝업 시 마우스 커서에 바로 위치시킬 메뉴 아이템의
인덱스입니다. (OS X에서만 지원합니다)
인덱스입니다. (macOS에서만 지원합니다)
### `menu.append(menuItem)`
@ -266,15 +266,15 @@ OS X의 네이티브 액션에 대해 자세히 알아보려면
메뉴가 가지고 있는 메뉴 아이템들의 배열입니다.
## OS X 애플리케이션 메뉴에 대해 알아 둬야 할 것들
## macOS 애플리케이션 메뉴에 대해 알아 둬야 할 것들
OS X에선 Windows, Linux와 달리 완전히 다른 애플리케이션 메뉴 스타일을 가지고 있습니다.
macOS에선 Windows, Linux와 달리 완전히 다른 애플리케이션 메뉴 스타일을 가지고 있습니다.
그래서 애플리케이션을 네이티브처럼 작동할 수 있도록 하기 위해 다음 몇 가지 유의 사항을
숙지해야 합니다.
### 기본 메뉴
OS X`Services``Windows`와 같은 많은 시스템 지정 기본 메뉴가 있습니다. 기본
macOS엔 `Services``Windows`와 같은 많은 시스템 지정 기본 메뉴가 있습니다. 기본
메뉴를 만들려면 반드시 다음 리스트 중 한 가지를 선택하여 메뉴의 `role`로 지정해야
합니다. 그러면 Electron이 자동으로 인식하여 해당 메뉴를 기본 메뉴로 만듭니다:
@ -284,13 +284,13 @@ OS X엔 `Services`나 `Windows`와 같은 많은 시스템 지정 기본 메뉴
### 메뉴 아이템 기본 동작
OS X는 몇가지 메뉴 아이템에 대해 `About xxx`, `Hide xxx`, `Hide Others`와 같은
macOS는 몇가지 메뉴 아이템에 대해 `About xxx`, `Hide xxx`, `Hide Others`와 같은
기본 동작을 제공하고 있습니다. 메뉴 아이템의 기본 동작을 지정하려면 반드시 메뉴
아이템의 `role` 속성을 지정해야 합니다.
### 메인 메뉴의 이름
OS X에선 지정한 애플리케이션 메뉴에 상관없이 메뉴의 첫번째 라벨은 언제나 애플리케이션의
macOS에선 지정한 애플리케이션 메뉴에 상관없이 메뉴의 첫번째 라벨은 언제나 애플리케이션의
이름이 됩니다. 애플리케이션 이름을 변경하려면 앱 번들내의 `Info.plist` 파일을 수정해야
합니다. 자세한 내용은 [About Information Property List Files][AboutInformationPropertyListFiles] 문서를 참고하세요.

View file

@ -79,7 +79,7 @@ let appIcon = new Tray('/Users/somebody/images/icon.png');
가장 일반적으로 템플릿 이미지는 밝고 어두운 테마 색상으로 변경할 수 있는 메뉴 바 아이콘
등에 사용되고 있습니다.
**참고:** 템플릿 이미지는 OS X 운영체제만 지원합니다.
**참고:** 템플릿 이미지는 macOS 운영체제만 지원합니다.
템플릿 이미지를 지정하려면 다음 예시와 같이 파일명에 `Template` 문자열을 추가해야
합니다:
@ -139,10 +139,10 @@ let image = nativeImage.createFromPath('/Users/somebody/images/icon.png');
이미지를 data URL로 반환합니다.
### `image.getNativeHandle()` _OS X_
### `image.getNativeHandle()` _macOS_
이미지의 네이티브 핸들 밑에 있는 C 포인터를 담은 [Buffer][buffer]을 반환합니다.
OS X에선, `NSImage` 인스턴스가 반환됩니다.
macOS에선, `NSImage` 인스턴스가 반환됩니다.
참고로 반환된 포인터는 복사본이 아닌 네이티브 이미지의 밑에 있는 약한 포인터이며,
따라서 반드시 관련된 `nativeImage` 인스턴스가 확실하게 유지되고 있는지를 인지해야

View file

@ -74,7 +74,7 @@ Causes the main thread of the current process crash.
Causes the main thread of the current process hang.
### `process.setFdLimit(maxDescriptors)` _OS X_ _Linux_
### `process.setFdLimit(maxDescriptors)` _macOS_ _Linux_
* `maxDescriptors` Integer
@ -133,7 +133,7 @@ On Windows / Linux:
현재 프로세스의 주 스레드를 중단시킵니다.
### `process.setFdLimit(maxDescriptors)` _OS X_ _Linux_
### `process.setFdLimit(maxDescriptors)` _macOS_ _Linux_
* `maxDescriptors` Integer

View file

@ -31,7 +31,7 @@ shell.openExternal('https://github.com');
### `shell.openExternal(url[, options])`
* `url` String
* `options` Object (optional) _OS X_
* `options` Object (optional) _macOS_
* `activate` Boolean - `true`로 설정하면 애플리케이션을 바로 활성화 상태로
실행합니다. 기본값은 `true`입니다.

View file

@ -4,17 +4,17 @@
## Methods
### `systemPreferences.isDarkMode()` _OS X_
### `systemPreferences.isDarkMode()` _macOS_
이 메서드는 시스템이 어두운 모드 상태인 경우 `true`를 반환하고 아닐 경우 `false`
반환합니다.
### `systemPreferences.subscribeNotification(event, callback)` _OS X_
### `systemPreferences.subscribeNotification(event, callback)` _macOS_
* `event` String
* `callback` Function
OS X의 네이티브 알림을 구독하며, 해당하는 `event`가 발생하면 `callback`
macOS의 네이티브 알림을 구독하며, 해당하는 `event`가 발생하면 `callback`
`callback(event, userInfo)` 형태로 호출됩니다. `userInfo`는 알림과 함께 전송되는
사용자 정보 딕셔너리를 포함하는 객체입니다.
@ -28,13 +28,13 @@ OS X의 네이티브 알림을 구독하며, 해당하는 `event`가 발생하
* `AppleColorPreferencesChangedNotification`
* `AppleShowScrollBarsSettingChanged`
### `systemPreferences.unsubscribeNotification(id)` _OS X_
### `systemPreferences.unsubscribeNotification(id)` _macOS_
* `id` Integer
`id`와 함께 구독자를 제거합니다.
### `systemPreferences.getUserDefault(key, type)` _OS X_
### `systemPreferences.getUserDefault(key, type)` _macOS_
* `key` String
* `type` String - `string`, `boolean`, `integer`, `float`, `double`, `url`,
@ -42,7 +42,7 @@ OS X의 네이티브 알림을 구독하며, 해당하는 `event`가 발생하
시스템 설정에서 `key`에 해당하는 값을 가져옵니다.
OS X에선 API가 `NSUserDefaults`를 읽어들입니다. 유명한 `key``type`은 다음과
macOS에선 API가 `NSUserDefaults`를 읽어들입니다. 유명한 `key``type`은 다음과
같습니다:
* `AppleInterfaceStyle: string`

View file

@ -71,9 +71,9 @@ appIcon.setContextMenu(contextMenu);
트레이 아이콘이 클릭될 때 발생하는 이벤트입니다.
**참고:** `bounds`는 OS X 와 Windows에서만 작동합니다.
**참고:** `bounds`macOS 와 Windows에서만 작동합니다.
### Event: 'right-click' _OS X_ _Windows_
### Event: 'right-click' _macOS_ _Windows_
* `event` Event
* `altKey` Boolean
@ -88,7 +88,7 @@ appIcon.setContextMenu(contextMenu);
트레이 아이콘을 오른쪽 클릭될 때 호출 됩니다.
### Event: 'double-click' _OS X_ _Windows_
### Event: 'double-click' _macOS_ _Windows_
* `event` Event
* `altKey` Boolean
@ -115,26 +115,26 @@ appIcon.setContextMenu(contextMenu);
풍선 팝업이 시간이 지나 사라지거나 유저가 클릭하여 닫을 때 발생하는 이벤트입니다.
### Event: 'drop' _OS X_
### Event: 'drop' _macOS_
드래그 가능한 아이템이 트레이 아이콘에 드롭되면 발생하는 이벤트입니다.
### Event: 'drop-files' _OS X_
### Event: 'drop-files' _macOS_
* `event`
* `files` Array - 드롭된 파일의 경로
트레이 아이콘에 파일이 드롭되면 발생하는 이벤트입니다.
### Event: 'drag-enter' _OS X_
### Event: 'drag-enter' _macOS_
트레이 아이콘에 드래그 작업이 시작될 때 발생하는 이벤트입니다.
### Event: 'drag-leave' _OS X_
### Event: 'drag-leave' _macOS_
트레이 아이콘에 드래그 작업이 종료될 때 발생하는 이벤트입니다.
### Event: 'drag-end' _OS X_
### Event: 'drag-end' _macOS_
트레이 아이콘에 드래그 작업이 종료되거나 다른 위치에서 종료될 때 발생하는 이벤트입니다.
@ -154,7 +154,7 @@ appIcon.setContextMenu(contextMenu);
`image`를 사용하여 트레이 아이콘의 이미지를 설정합니다.
### `Tray.setPressedImage(image)` _OS X_
### `Tray.setPressedImage(image)` _macOS_
* `image` [NativeImage](native-image.md)
@ -166,13 +166,13 @@ appIcon.setContextMenu(contextMenu);
트레이 아이콘의 툴팁 텍스트를 설정합니다.
### `Tray.setTitle(title)` _OS X_
### `Tray.setTitle(title)` _macOS_
* `title` String
상태바에서 트레이 아이콘 옆에 표시되는 제목 텍스트를 설정합니다.
### `Tray.setHighlightMode(highlight)` _OS X_
### `Tray.setHighlightMode(highlight)` _macOS_
* `highlight` Boolean
@ -188,7 +188,7 @@ appIcon.setContextMenu(contextMenu);
트레이에 풍선 팝업을 생성합니다.
### `Tray.popUpContextMenu([menu, position])` _OS X_ _Windows_
### `Tray.popUpContextMenu([menu, position])` _macOS_ _Windows_
* `menu` Menu (optional)
* `position` Object (optional) - 팝업 메뉴의 위치

View file

@ -944,7 +944,7 @@ win.webContents.on('did-finish-load', () => {
});
```
### `webContents.showDefinitionForSelection()` _OS X_
### `webContents.showDefinitionForSelection()` _macOS_
페이지에서 선택된 단어에 대한 사전 검색 결과 팝업을 표시합니다.

View file

@ -478,7 +478,7 @@ Service worker에 대한 개발자 도구를 엽니다.
`event` 객체에 대해 자세히 알아보려면 [webContents.sendInputEvent](web-contents.md##webcontentssendinputeventevent)를
참고하세요.
### `<webview>.showDefinitionForSelection()` _OS X_
### `<webview>.showDefinitionForSelection()` _macOS_
페이지에서 선택된 단어에 대한 사전 검색 결과 팝업을 표시합니다.

View file

@ -1,10 +1,10 @@
# 빌드 설명서 (OS X)
# 빌드 설명서 (macOS)
이 가이드는 OS X 운영체제에서 Electron을 빌드하는 방법을 설명합니다.
이 가이드는 macOS 운영체제에서 Electron을 빌드하는 방법을 설명합니다.
## 빌드전 요구 사항
* OS X >= 10.8
* macOS >= 10.8
* [Xcode](https://developer.apple.com/technologies/tools/) >= 5.1
* [node.js](http://nodejs.org) (external)
@ -47,7 +47,7 @@ $ ./script/build.py -c D
## 32비트 지원
Electron은 현재 OS X 64비트만 지원하고 있습니다. 그리고 앞으로도 OS X 32비트는 지원할
Electron은 현재 macOS 64비트만 지원하고 있습니다. 그리고 앞으로도 macOS 32비트는 지원할
계획이 없습니다.
## 테스트

View file

@ -27,7 +27,7 @@ Electron 문서를 작성하는 규칙은 다음과 같습니다.
- 선택적 인수는 목록에서 호출되면 표시합니다.
- 문장의 길이는 한 줄당 80 칸을 유지합니다.
- 플랫폼 특정 메서드 헤더는 이탈릭체로 표시합니다.
- ```### `method(foo, bar)` _OS X_```
- ```### `method(foo, bar)` _macOS_```
- 'on' 표현 대신 'in the ___ process' 형식의 표현을 지향합니다.
### 번역된 참조 문서

View file

@ -3,10 +3,10 @@
Electron 애플리케이션을 배포하는 방법은 간단합니다.
먼저 폴더 이름을 `app`로 지정한 후 Electron 리소스 디렉터리에 폴더를 통째로 집어넣기만
하면 됩니다. 리소스 디렉터리는 OS X의 경우: `Electron.app/Contents/Resources/`
하면 됩니다. 리소스 디렉터리는 macOS의 경우: `Electron.app/Contents/Resources/`
Windows와 Linux의 경우: `resources/` 입니다.
OS X의 경우:
macOS의 경우:
```text
electron/Electron.app/Contents/Resources/app/
@ -37,7 +37,7 @@ electron/resources/app
`app.asar` 파일로 대체하면됩니다. Electron은 자동으로 `app`폴더 대신 asar 아카이브를
기반으로 애플리케이션을 실행합니다.
OS X의 경우:
macOS의 경우:
```text
electron/Electron.app/Contents/Resources/
@ -62,7 +62,7 @@ electron/resources/
[rcedit](https://github.com/atom/rcedit)를 통해 `electron.exe`을 원하는 이름으로
변경할 수 있고, 또한 아이콘과 기타 정보도 변경할 수 있습니다.
### OS X
### macOS
`Electron.app`을 원하는 이름으로 변경할 수 있습니다. 그리고 다음 표시된 애플리케이션
내부 파일에서 `CFBundleDisplayName`, `CFBundleIdentifier` 그리고 `CFBundleName`

View file

@ -2,14 +2,14 @@
애플리케이션 배포의 대상이 되는 서로 다른 운영체제 시스템의 환경에 맞춰 애플리케이션의
기능을 통합할 수 있습니다. 예를 들어 Windows에선 태스크바의 JumpList에 바로가기를
추가할 수 있고 Mac(OS X)에선 dock 메뉴에 커스텀 메뉴를 추가할 수 있습니다.
추가할 수 있고 Mac(macOS)에선 dock 메뉴에 커스텀 메뉴를 추가할 수 있습니다.
이 문서는 Electron API를 이용하여 각 운영체제 시스템의 기능을 활용하는 방법을
설명합니다.
## 데스크톱 알림 (Windows, Linux, OS X)
## 데스크톱 알림 (Windows, Linux, macOS)
Windows, Linux, OS X 운영체제 모두 기본적으로 애플리케이션에서 유저에게 알림을 보내는
Windows, Linux, macOS 운영체제 모두 기본적으로 애플리케이션에서 유저에게 알림을 보내는
방법을 제공합니다. Electron은 [HTML5 Notification API](https://notifications.spec.whatwg.org/)를
통해 개발자가 편리하게 데스크톱 알림을 사용할 수 있는 기능을 제공합니다. 데스크톱 알림은
운영체제의 네이티브 알림 API를 사용하여 표시합니다.
@ -47,18 +47,18 @@ myNotification.onclick = () => {
따르는 모든 데스크탑 환경에서 데스크톱 알림 기능을 사용할 수 있습니다. Cinnamon,
Enlightenment, Unity, GNOME, KDE등을 지원합니다.
### OS X
### macOS
OS X에서의 데스크톱 알림은 아주 직관적입니다. 하지만 데스크톱 알림을 사용할 땐
macOS에서의 데스크톱 알림은 아주 직관적입니다. 하지만 데스크톱 알림을 사용할 땐
[Apple's Human Interface guidelines regarding notifications](https://developer.apple.com/library/mac/documentation/UserExperience/Conceptual/OSXHIGuidelines/NotificationCenter.html)
가이드를 고려해야 합니다.
참고로 데스크롭 알림의 최대 길이는 256 바이트 입니다. 길이가 초과할 경우 초과한 글자가
잘립니다.
## 최근 사용한 문서 (Windows & OS X)
## 최근 사용한 문서 (Windows & macOS)
Windows와 OS X는 JumpList 또는 dock 메뉴를 통해 최근 문서 리스트에 쉽게 접근할 수
Windows와 macOS는 JumpList 또는 dock 메뉴를 통해 최근 문서 리스트에 쉽게 접근할 수
있습니다.
__JumpList:__
@ -93,13 +93,13 @@ app.clearRecentDocuments();
유저가 JumpList에서 파일을 클릭할 경우 클릭된 파일의 경로가 커맨드 라인 인수로 추가되어
새로운 인스턴스의 애플리케이션이 실행됩니다.
### OS X에서 주의할 점
### macOS에서 주의할 점
파일이 최근 문서 메뉴에서 요청될 경우 `app` 모듈의 `open-file` 이벤트가 호출됩니다.
## 커스텀 독 메뉴 (OS X)
## 커스텀 독 메뉴 (macOS)
OS X는 개발자가 dock에 커스텀 메뉴를 만들 수 있도록 허용하고 있습니다.
macOS는 개발자가 dock에 커스텀 메뉴를 만들 수 있도록 허용하고 있습니다.
보통 애플리케이션의 특정 기능 바로가기를 만들 때 사용합니다:
__Terminal.app의 dock menu:__
@ -107,7 +107,7 @@ __Terminal.app의 dock menu:__
<img src="https://cloud.githubusercontent.com/assets/639601/5069962/6032658a-6e9c-11e4-9953-aa84006bdfff.png" height="354" width="341" >
커스텀 dock menu를 설정하려면 `app.dock.setMenu` API를 사용하면 됩니다.
OS X에서만 사용 가능합니다:
macOS에서만 사용 가능합니다:
```javascript
const {app, Menu} = require('electron');
@ -147,7 +147,7 @@ __Internet Explorer의 작업:__
![IE](http://i.msdn.microsoft.com/dynimg/IC420539.png)
OS X의 dock menu(진짜 메뉴)와는 달리 Windows의 사용자 작업은 애플리케이션 바로
macOS의 dock menu(진짜 메뉴)와는 달리 Windows의 사용자 작업은 애플리케이션 바로
가기처럼 작동합니다. 유저가 작업을 클릭할 때 설정한 인수와 함께 새로운 애플리케이션이
실행됩니다.
@ -241,13 +241,13 @@ __Audacious의 런처 숏컷:__
![audacious](https://help.ubuntu.com/community/UnityLaunchersAndDesktopFiles?action=AttachFile&do=get&target=shortcuts.png)
## 작업 표시줄 안의 프로그래스 바 (Windows, OS X, Unity)
## 작업 표시줄 안의 프로그래스 바 (Windows, macOS, Unity)
Windows에선 작업 표시줄의 애플리케이션 버튼에 프로그래스 바를 추가할 수 있습니다.
이 기능은 사용자가 애플리케이션의 창을 열지 않고도 애플리케이션의 작업의 상태 정보를
시각적으로 보여줄 수 있도록 해줍니다.
OS X에선 프로그래스바가 dock 아이콘의 일부에 표시됩니다.
macOS에선 프로그래스바가 dock 아이콘의 일부에 표시됩니다.
또한 Unity DE도 런처에 프로그래스 바를 부착할 수 있습니다.
@ -290,9 +290,9 @@ let win = new BrowserWindow({...});
win.setOverlayIcon('path/to/overlay.png', 'Description for overlay');
```
## 대표 파일 제시 (OS X)
## 대표 파일 제시 (macOS)
OS X는 창에서 대표 파일을 설정할 수 있습니다. 타이틀바에서 파일 아이콘이 있고, 사용자가
macOS는 창에서 대표 파일을 설정할 수 있습니다. 타이틀바에서 파일 아이콘이 있고, 사용자가
Command-Click 또는 Control-Click 키를 누를 경우 파일 경로 팝업이 보여집니다. 또한
창의 상태도 지정할 수 있습니다. 다시 말해 로드된 문서의 수정 여부를 제목의 파일
아이콘에 표시할 수 있습니다.

View file

@ -23,7 +23,7 @@ Electron에 확장 기능을 로드하려면, Chrome 브라우저에서 다운
* `~/.config/google-chrome-beta/Default/Extensions/`
* `~/.config/google-chrome-canary/Default/Extensions/`
* `~/.config/chromium/Default/Extensions/`
* OS X에선 `~/Library/Application Support/Google/Chrome/Default/Extensions`.
* macOS에선 `~/Library/Application Support/Google/Chrome/Default/Extensions`.
4. 확장 기능의 경로를 `BrowserWindow.addDevToolsExtension` API로 전달합니다.
React Developer Tools의 경우 다음과 비슷해야 합니다:
`~/Library/Application Support/Google/Chrome/Default/Extensions/fmkadmapgofadopljbjfkapdkoienihi/0.14.10_0`

View file

@ -116,7 +116,7 @@ codesign -s "$APP_KEY" -f --entitlements "$PARENT_PLIST" "$APP_PATH"
productbuild --component "$APP_PATH" /Applications --sign "$INSTALLER_KEY" "$RESULT_PATH"
```
만약 OS X의 샌드박스 개념에 대해 처음 접한다면 Apple의 [Enabling App Sandbox][enable-app-sandbox]
만약 macOS의 샌드박스 개념에 대해 처음 접한다면 Apple의 [Enabling App Sandbox][enable-app-sandbox]
문서를 참고하여 기본적인 개념을 이해해야 합니다. 그리고 자격(plist) 파일에
애플리케이션에서 요구하는 권한의 키를 추가합니다.

View file

@ -112,7 +112,7 @@ app.on('ready', createWindow);
// 모든 창이 닫히면 애플리케이션 종료.
app.on('window-all-closed', () => {
// OS X의 대부분의 애플리케이션은 유저가 Cmd + Q 커맨드로 확실하게
// macOS의 대부분의 애플리케이션은 유저가 Cmd + Q 커맨드로 확실하게
// 종료하기 전까지 메뉴바에 남아 계속 실행됩니다.
if (process.platform !== 'darwin') {
app.quit();
@ -120,7 +120,7 @@ app.on('window-all-closed', () => {
});
app.on('activate', () => {
// OS X에선 보통 독 아이콘이 클릭되고 나서도
// macOS에선 보통 독 아이콘이 클릭되고 나서도
// 열린 윈도우가 없으면, 새로운 윈도우를 다시 만듭니다.
if (win === null) {
createWindow();
@ -196,7 +196,7 @@ $ .\electron\electron.exe your-app\
$ ./electron/electron your-app/
```
#### OS X
#### macOS
```bash
$ ./Electron.app/Contents/MacOS/Electron your-app/

View file

@ -2,9 +2,9 @@
Electron에선 다음과 같은 플랫폼을 지원합니다:
### OS X
### macOS
OS X는 64비트 바이너리만 제공됩니다. 그리고 최소 OS X 지원 버전은 10.9입니다.
macOS는 64비트 바이너리만 제공됩니다. 그리고 최소 macOS 지원 버전은 10.9입니다.
### Windows

View file

@ -18,11 +18,11 @@ Electron의 Chromium은 자동적으로 `$DISPLAY` 변수를 찾습니다. 따
다른 설정이 필요하지 않습니다. 이러한 작업은 Paul Betts의
[xvfb-maybe](https://github.com/paulcbetts/xvfb-maybe)를 통해 자동화 할 수
있습니다: `xvfb-maybe`를 테스트 커맨드 앞에 추가하고 현재 시스템에서 요구하면
이 작은 툴이 자동적으로 xvfb를 설정합니다. Windows와 Mac OS X에선 간단히 아무 작업도
이 작은 툴이 자동적으로 xvfb를 설정합니다. Windows와 macOS에선 간단히 아무 작업도
하지 않습니다.
```
## Windows와 OS X에선, 그저 electron-mocha를 호출합니다
## Windows와 macOS에선, 그저 electron-mocha를 호출합니다
## Linux에선, 현재 headless 환경에 있는 경우
## xvfb-run electron-mocha ./test/*.js와 같습니다
xvfb-maybe electron-mocha ./test/*.js

View file

@ -19,7 +19,7 @@ Electron은 Pepper 플래시 플러그인을 지원합니다. Electron에서 Pep
```javascript
// 플래시 플러그인의 위치를 설정합니다.
// Windows의 경우, /path/to/pepflashplayer.dll 또는 main.js에 존재하는 경우 pepflashplayer.dll
// OS X의 경우, /path/to/PepperFlashPlayer.plugin
// macOS의 경우, /path/to/PepperFlashPlayer.plugin
// Linux의 경우, /path/to/libpepflashplayer.so
app.commandLine.appendSwitch('ppapi-flash-path', '/path/to/libpepflashplayer.so');

View file

@ -12,7 +12,7 @@ Chrome 브라우저를 설치해야 합니다.
같습니다, 만약 그렇지 않다면 `navigator.plugins`가 로드됐더라도 정상적으로 작동하지
않습니다.
### Windows & OS X
### Windows & macOS
Chrome 브라우저에서 `chrome://components/`를 열고 `WidevineCdm`을 찾은 후 확실히
최신버전인지 확인합니다. 여기까지 하면 모든 플러그인 바이너리를
@ -20,13 +20,13 @@ Chrome 브라우저에서 `chrome://components/`를 열고 `WidevineCdm`을 찾
디렉터리에서 찾을 수 있습니다.
`APP_DATA`는 애플리케이션 데이터를 저장하고 있는 시스템 경로입니다. Windows에선
`%LOCALAPPDATA%`로 접근할 수 있고 OS X에선 `~/Library/Application Support`
`%LOCALAPPDATA%`로 접근할 수 있고 macOS에선 `~/Library/Application Support`
접근할 수 있습니다. `VERSION``1.4.8.866` 같은 Widevine CDM 플러그인의 버전
문자열입니다. `PLATFORM`은 플랫폼을 뜻하며 `mac` 또는 `win`이 될 수 있으며 `ARCH`
아키텍쳐를 뜻하고 `x86` 또는 `x64`가 될 수 있습니다.
Windows에선 `widevinecdm.dll``widevinecdmadapter.dll` 같은 바이너리를
요구하며 OS X에선 `libwidevinecdm.dylib``widevinecdmadapter.plugin` 바이너리를
요구하며 macOS에선 `libwidevinecdm.dylib``widevinecdmadapter.plugin` 바이너리를
요구합니다. 원하는 곳에 이들을 복사해 놓을 수 있습니다. 하지만 반드시 바이너리는 같은
위치에 두어야 합니다.
@ -52,7 +52,7 @@ Linux에선 플러그인 바이너리들이 Chrome 브라우저와 함께 제공
```javascript
// `widevinecdmadapter`의 파일 이름을 이곳에 전달해야 합니다. 파일 이름은
// * OS X에선 `widevinecdmadapter.plugin`로 지정합니다,
// * macOS에선 `widevinecdmadapter.plugin`로 지정합니다,
// * Linux에선 `libwidevinecdmadapter.so`로 지정합니다,
// * Windows에선 `widevinecdmadapter.dll`로 지정합니다.
app.commandLine.appendSwitch('widevine-cdm-path', '/path/to/widevinecdmadapter.plugin');

View file

@ -11,11 +11,11 @@ Exemplos:
## Aviso sobre plataformas
No Linux e no Windows a tecla `Command` não tem nenhum efeito,
então use `CommandOrControl` que representa a tecla `Command` existente no OS X e
então use `CommandOrControl` que representa a tecla `Command` existente no macOS e
`Control` no Linux e no Windows para definir aceleradores (atalhos).
A chave `Super` está mapeada para a tecla `Windows` para Windows e Linux,
e para a tecla `Cmd` para OS X.
e para a tecla `Cmd` para macOS.
## Modificadores disponíveis

View file

@ -18,7 +18,7 @@ O objeto `app` emite os seguintes eventos:
### Evento: 'will-finish-launching'
Emitido quando o aplicativo finaliza a inicialização básica. No Windows e no Linux,
o evento `will-finish-launching` é o mesmo que o evento `ready`; No OS X,
o evento `will-finish-launching` é o mesmo que o evento `ready`; No macOS,
esse evento representa a notificação `applicationWillFinishLaunching` do `NSApplication`.
Normalmente aqui seriam criados *listeners* para os eventos `open-file` e `open-url`, e inicializar o *crash reporter* e atualizador automático.
@ -65,7 +65,7 @@ evento `will-quit` e `window-all-closed`.
Emitido quando o aplicativo está finalizando.
### Evento: 'open-file' _OS X_
### Evento: 'open-file' _macOS_
Retorna:
@ -85,7 +85,7 @@ Você deve chamar `event.preventDefault()` se quiser cuidar deste caso.
No Windows, você deve fazer o *parse* do `process.argv` para pegar o
endereço do arquivo.
### Evento: 'open-url' _OS X_
### Evento: 'open-url' _macOS_
Retorna:
@ -97,7 +97,7 @@ ser registrado para ser aberto pelo seu aplicativo.
Você deve chamar `event.preventDefault()` se quiser cuidar deste caso.
### Evento: 'activate' _OS X_
### Evento: 'activate' _macOS_
Retorna:
@ -266,7 +266,7 @@ Você pode requisitar os seguintes endereços pelo nome:
* `appData` Diretório de dados do aplicativo por usuário, que por padrão aponta para:
* `%APPDATA%` no Windows
* `$XDG_CONFIG_HOME` ou `~/.config` no Linux
* `~/Library/Application Support` no OS X
* `~/Library/Application Support` no macOS
* `userData` O diretório para guardar os arquivos de configuração do seu aplicativo, que por padrão é o diretório `appData` concatenado com o nome do seu aplicativo.
* `temp` Diretório temporário.
* `exe` O arquivo executável atual.
@ -312,16 +312,16 @@ seu aplicativo, e que será preferido ao `name` pelo Electron.
Retorna a localidade atual do aplicativo.
### `app.addRecentDocument(path)` _OS X_ _Windows_
### `app.addRecentDocument(path)` _macOS_ _Windows_
* `path` String
Adiciona `path` à lista de documentos recentes.
Esta lista é gerenciada pelo S.O.. No Windows você pode visitar a lista pela
barra de tarefas, e no OS X você pode visita-la pelo *dock*.
barra de tarefas, e no macOS você pode visita-la pelo *dock*.
### `app.clearRecentDocuments()` _OS X_ _Windows_
### `app.clearRecentDocuments()` _macOS_ _Windows_
Limpa a lista de documentos recentes.
@ -361,7 +361,7 @@ Normalmente aplicativos respondem à isso não minimizando sua janela primária
Este método retorna `false` caso seu processo seja a instância primária do aplicativo e seu aplicativo deve continuar carregando. E retorna `true` caso seu processo tenha enviado seus parâmetros para outra instância, e você deve imediatamente finalizar.
No OS X o sistema enforça instância única automaticamente quando usuários tentam abrir uma segunda instância do seu aplicativo no *Finder*, e os eventos `open-file` e `open-url` serão emitidos para isso. Entretanto, quando usuários inicializam seu aplicativo na linha de comando, o mecanismo de instância única do sistema será ignorado e você terá de utilizar esse método para assegurar-se de ter uma instância única.
No macOS o sistema enforça instância única automaticamente quando usuários tentam abrir uma segunda instância do seu aplicativo no *Finder*, e os eventos `open-file` e `open-url` serão emitidos para isso. Entretanto, quando usuários inicializam seu aplicativo na linha de comando, o mecanismo de instância única do sistema será ignorado e você terá de utilizar esse método para assegurar-se de ter uma instância única.
Um exemplo de ativação da janela de primeira instância quando uma segunda instância inicializa:
@ -405,7 +405,7 @@ Adiciona um argumento à linha de comando do Chromium. O argumento será passado
**Nota:** Isto não irá afetar `process.argv`.
### `app.dock.bounce([type])` _OS X_
### `app.dock.bounce([type])` _macOS_
* `type` String (opcional) - Pode ser `critical` ou `informational`. O padrão é
`informational`
@ -417,31 +417,31 @@ Entretanto, a requisição se mantém ativa até que o aplicativo se torne ativo
Retorna um ID representando a requisição.
### `app.dock.cancelBounce(id)` _OS X_
### `app.dock.cancelBounce(id)` _macOS_
* `id` Integer
Cancela o salto do `id`.
### `app.dock.setBadge(text)` _OS X_
### `app.dock.setBadge(text)` _macOS_
* `text` String
Define a string a ser exibida na área de *badging* do *dock*.
### `app.dock.getBadge()` _OS X_
### `app.dock.getBadge()` _macOS_
Retorna a string da *badge* do *dock*.
### `app.dock.hide()` _OS X_
### `app.dock.hide()` _macOS_
Esconde o ícone do *dock*.
### `app.dock.show()` _OS X_
### `app.dock.show()` _macOS_
Exibe o ícone do *dock*.
### `app.dock.setMenu(menu)` _OS X_
### `app.dock.setMenu(menu)` _macOS_
* `menu` Menu

View file

@ -6,9 +6,9 @@ Este módulo oferece uma interface para o framework de atualização automática
Embora o `autoUpdater` ofereça uma API uniforme para diferentes plataformas, existem diferenças sutis em cada plataforma.
### OS X
### macOS
No OS X, o módulo `autoUpdater` é construído sobre o [Squirrel.Mac][squirrel-mac], o que significa que você não precisa de nenhuma configuração especial para fazê-lo funcionar. Para requerimentos de servidor, você pode ler [Server Support][server-support].
No macOS, o módulo `autoUpdater` é construído sobre o [Squirrel.Mac][squirrel-mac], o que significa que você não precisa de nenhuma configuração especial para fazê-lo funcionar. Para requerimentos de servidor, você pode ler [Server Support][server-support].
### Windows
@ -16,7 +16,7 @@ No Windows, você deve instalar seu aplicativo na máquina de um usuário antes
O instalador gerado com Squirrel irá criar um ícone de atalho com um [Application User Model ID][app-user-model-id] no formato `com.squirrel.PACKAGE_ID.YOUR_EXE_WITHOUT_DOT_EXE`, por exemplo: `com.squirrel.slack.Slack` e `com.squirrel.code.Code`. Você precisa usar o mesmo ID para seu aplicativo a API `app.setAppUserModelId`, senão o Windows não conseguirá fixar seu aplicativo corretamente na barra de tarefas.
A configuração do servidor também é diferente do OS X. Você pode ler a documentação do [Squirrel.Windows][squirrel-windows] para mais detalhes.
A configuração do servidor também é diferente do macOS. Você pode ler a documentação do [Squirrel.Windows][squirrel-windows] para mais detalhes.
### Linux

View file

@ -38,7 +38,7 @@ Ela cria uma nova `BrowserWindow` com propriedades nativas definidas pelo `optio
* `maxHeight` Integer - Altura máxima da janela. O padrão é sem limites.
* `resizable` Boolean - Se é possível modificar o tamanho da janela. O padrão é `true`.
* `alwaysOnTop` Boolean - Se a janela deve sempre ficar à frente de outras janelas. O padrão é `false`.
* `fullscreen` Boolean - Se a janela deve estar em tela cheia. Quando definido como `false`, o botão de tela cheia estará escondido ou desabilitado no OS X. O padrão é `false`.
* `fullscreen` Boolean - Se a janela deve estar em tela cheia. Quando definido como `false`, o botão de tela cheia estará escondido ou desabilitado no macOS. O padrão é `false`.
* `skipTaskbar` Boolean - Se deve mostrar a janela na barra de tarefas. O padrão é `false`.
* `kiosk` Boolean - Modo *kiosk*. O padrão é `false`.
* `title` String - Título padrão da janela. O padrão é `"Electron"`.
@ -55,8 +55,8 @@ Ela cria uma nova `BrowserWindow` com propriedades nativas definidas pelo `optio
* `type` String - Define o tipo da janela, que aplica propriedades adicionais específicas da plataforma. Por padrão é indefinido e será criada uma janela de aplicativo comum. Possíveis valores:
* No Linux, os tipos possíveis são `desktop`, `dock`, `toolbar`, `splash`,
`notification`.
* No OS X, os tipos possíveis são `desktop`, `textured`. O tipo `textured` adiciona a aparência degradê metálica (`NSTexturedBackgroundWindowMask`). O tipo `desktop` coloca a janela no nível do fundo de tela do desktop (`kCGDesktopWindowLevel - 1`). Note que a janela `desktop` não irá receber foco, eventos de teclado ou mouse, mas você pode usar `globalShortcut` para receber entrada de dados ocasionalmente.
* `titleBarStyle` String, OS X - Define o estilo da barra de título da janela. Esta opção está suportada a partir da versão OS X 10.10 Yosemite. Há três possíveis valores:
* No macOS, os tipos possíveis são `desktop`, `textured`. O tipo `textured` adiciona a aparência degradê metálica (`NSTexturedBackgroundWindowMask`). O tipo `desktop` coloca a janela no nível do fundo de tela do desktop (`kCGDesktopWindowLevel - 1`). Note que a janela `desktop` não irá receber foco, eventos de teclado ou mouse, mas você pode usar `globalShortcut` para receber entrada de dados ocasionalmente.
* `titleBarStyle` String, macOS - Define o estilo da barra de título da janela. Esta opção está suportada a partir da versão macOS 10.10 Yosemite. Há três possíveis valores:
* `default` ou não definido, resulta na barra de título cinza opaca padrão do Mac.
* `hidden` resulta numa barra de título oculta e a janela de conteúdo no tamanho máximo, porém a barra de título ainda possui os controles padrões de janela ("semáforo") no canto superior esquerdo.
* `hidden-inset` resulta numa barra de título oculta com uma aparência alternativa onde os botões de semáforo estão ligeiramente mais longe do canto da janela.
@ -165,9 +165,9 @@ Emitido quando o tamanho da janela está sendo alterado.
Emitido quando está sendo movida para uma nova posição.
__Note__: No OS X este evento é apenas um apelido de `moved`.
__Note__: No macOS este evento é apenas um apelido de `moved`.
### Evento: 'moved' _OS X_
### Evento: 'moved' _macOS_
Emitido uma vez quando a janela é movida para uma nova posição.
@ -331,7 +331,7 @@ Define se a janela deve estar em modo tela cheia.
Retorna um boolean, indicando se a janela está em modo tela cheia.
### `win.setAspectRatio(aspectRatio[, extraSize])` _OS X_
### `win.setAspectRatio(aspectRatio[, extraSize])` _macOS_
* `aspectRatio` A proporção que queremos manter para uma porção do conteúdo da *view*.
* `extraSize` Object (opcional) - O tamanho extra não incluído enquanto a proporção é mantida. Propriedades:
@ -493,23 +493,23 @@ Desengancha a mensagem de janela.
Desengancha todas as mensagens de janela.
### `win.setRepresentedFilename(filename)` _OS X_
### `win.setRepresentedFilename(filename)` _macOS_
* `filename` String
Define o endereço do arquivo que a janela representa, e o ícone do arquivo será exibido na barra de título da janela.
### `win.getRepresentedFilename()` _OS X_
### `win.getRepresentedFilename()` _macOS_
Retorna o endereço do arquivo que a janela representa.
### `win.setDocumentEdited(edited)` _OS X_
### `win.setDocumentEdited(edited)` _macOS_
* `edited` Boolean
Define se o documento da janela foi editado, e o ícone na barra de título se torna cinza quando definido como `true`.
### `win.isDocumentEdited()` _OS X_
### `win.isDocumentEdited()` _macOS_
Retorna um boolean indicando se o documento da janela foi editado.
@ -581,7 +581,7 @@ Adiciona uma barra de ferramentes miniatura com um conjunto de botões específi
O número de botões na barra de ferramentas miniatura não deve ser maior que 7 devido ao espaço limitado. Uma vez que você define a barra de ferramentas miniatura, ela não pode ser removida por causa da limitação da plataforma. Mas você pode chamar a API com um array vazio para limpar todos os botões.
### `win.showDefinitionForSelection()` _OS X_
### `win.showDefinitionForSelection()` _macOS_
Mostra um dicionário *pop-up* que procura a palavra selecionada na página.

View file

@ -40,7 +40,7 @@ O objeto `process` tem os seguintes métodos:
Faz com que o *thread* principal do processo congele.
### `process.setFdLimit(maxDescriptors)` _OS X_ _Linux_
### `process.setFdLimit(maxDescriptors)` _macOS_ _Linux_
* `maxDescriptors` Integer

View file

@ -23,7 +23,7 @@ Estas são as formas que escrevemos a documentação do Electron.
- Argumentos opcionais são indicados quando chamado na lista.
- Comprimento da linha é de 80 caracteres com colunas quebradas.
- Métodos específicos para uma plataforma são postos em itálico seguindo o cabeçalho do método.
- ```### `method(foo, bar)` _OS X_```
- ```### `method(foo, bar)` _macOS_```
## Lendo a documentação do Electron

View file

@ -63,7 +63,7 @@ antes de distribuí-lo aos usuários.
Você pode renomear `electron.exe` para o nome que desejar e editar o seu ícone e outras
informações com ferramentas como [rcedit](https://github.com/atom/rcedit).
### OS X
### macOS
Você pode renomear `Electron.app` para o nome que desejar e também pode mudar o nome
do `CFBundleDisplayName`, `CFBundleIdentifier` e os campos em `CFBundleName`

View file

@ -8,9 +8,9 @@ menu customizado na dock.
Este guia explica como integrar suas aplicações no ambiente desktop com a API
do Electron.
## Documentos Recentes (Windows & OS X)
## Documentos Recentes (Windows & macOS)
O Windows e o OS X disponibilizam um acesso fácil para a lista de arquivos
O Windows e o macOS disponibilizam um acesso fácil para a lista de arquivos
abertos recentemente pela aplicação através do JumpList ou Dock Menu respectivamente.
__JumpList:__
@ -48,14 +48,14 @@ Quando um usuário clica em um arquivo na JumpList, uma nova instância da sua a
deve ser iniciada com o caminho do arquivo adicionado como um argumento de
linha de comando.
### Notas para OS X
### Notas para macOS
Quando um arquivo for requisitado pelo menu de documentos recentes, o evento `open-file`
do módulo `app` irá ser emitido.
## Dock Menu customizado (OS X)
## Dock Menu customizado (macOS)
OS X permite que desenvolvedores especifiquem um menu customizado para a dock,
macOS permite que desenvolvedores especifiquem um menu customizado para a dock,
que normalmente contém alguns atalhos para as funcionalidades mais utilizadas
da sua aplicação.
@ -64,7 +64,7 @@ __Dock menu do Terminal.app:__
<img src="https://cloud.githubusercontent.com/assets/639601/5069962/6032658a-6e9c-11e4-9953-aa84006bdfff.png" height="354" width="341" >
Para criar seu Dock Menu customizado, você pode usar a API `app.dock.setMenu`,
ela está disponível apenas no OS X:
ela está disponível apenas no macOS:
```javascript
var app = require('app');
@ -106,7 +106,7 @@ __Tarefas do Internet Explorer:__
![IE](http://i.msdn.microsoft.com/dynimg/IC420539.png)
Ao contrário do Menu Dock no OS X que é um verdadeiro menu, tarefas do usuário no Windows
Ao contrário do Menu Dock no macOS que é um verdadeiro menu, tarefas do usuário no Windows
funcionam como atalhos, de uma forma que quando o usuário clica em uma tarefa, um programa
deve ser executado com os argumentos especificados.
@ -226,9 +226,9 @@ var window = new BrowserWindow({...});
window.setProgressBar(0.5);
```
## Representação do arquivo na janela (OS X)
## Representação do arquivo na janela (macOS)
No OS X, uma janela pode possuir a representação de um arquivo na barra de título,
No macOS, uma janela pode possuir a representação de um arquivo na barra de título,
permitindo que ao usuário acionar um Command-Click ou Control-Click sobre o título da janela,
uma pop-up de navegação entre arquivos é exibida.

View file

@ -88,7 +88,7 @@ var mainWindow = null;
// Sair quando todas as janelas estiverem fechadas.
app.on('window-all-closed', function() {
// No OS X é comum para as aplicações na barra de menu
// No macOS é comum para as aplicações na barra de menu
// continuarem ativas até que o usuário saia explicitamente
// com Cmd + Q
if (process.platform != 'darwin') {
@ -173,7 +173,7 @@ $ .\electron\electron.exe seu-app\
$ ./electron/electron seu-app/
```
#### OS X
#### macOS
```bash
$ ./Electron.app/Contents/MacOS/Electron seu-app/

View file

@ -2,9 +2,9 @@
As plataformas suportadas por Electron são:
### OS X
### macOS
Somente binarios em 64bit são construidos para OS X e a versão mínima suportada é OS X 10.9.
Somente binarios em 64bit são construidos para macOS e a versão mínima suportada é macOS 10.9.
### Windows
Suporte para Windows 7 ou superior, versões anteriores não são suportados (e não ira funcionar)

View file

@ -6,7 +6,7 @@ habilitado em sua aplicação.
## Prepare uma cópia do plugin Flash
Tanto no OS X como no Linux, os detalhes do plugin Pepper Flash podem ser
Tanto no macOS como no Linux, os detalhes do plugin Pepper Flash podem ser
encontrados navegando por `chrome://plugins` no navegador Chrome. Essa
localização e versão são úteis para o suporte do plugin Electron's Pepper Flash.
Você pode também copiar para outra localização.
@ -36,7 +36,7 @@ app.on('window-all-closed', function() {
// Epecifica o caminho do flash.
// No Windows, deve ser /path/to/pepflashplayer.dll
// No OS X, /path/to/PepperFlashPlayer.plugin
// No macOS, /path/to/PepperFlashPlayer.plugin
// No Linux, /path/to/libpepflashplayer.so
app.commandLine.appendSwitch('ppapi-flash-path', '/path/to/libpepflashplayer.so');

View file

@ -75,7 +75,7 @@
* [Структура папок с исходным кодом](development/source-code-directory-structure.md)
* [Technical Differences to NW.js (formerly node-webkit)](development/atom-shell-vs-node-webkit.md)
* [Обзор системы сборки](development/build-system-overview.md)
* [Инструкции по сборке (OS X)](development/build-instructions-osx.md)
* [Инструкции по сборке (macOS)](development/build-instructions-osx.md)
* [Инструкции по сборке (Windows)](development/build-instructions-windows.md)
* [Инструкции по сборке (Linux)](development/build-instructions-linux.md)
* [Настройка сервера символов для отладчика](development/setting-up-symbol-server.md)

View file

@ -1,11 +1,11 @@
# Распространение приложения
Чтобы разпространять ваше приложение на Electron, папка с вашим приложением
должна называться `app` и находиться в папке ресурсов Electron (в OS X это
должна называться `app` и находиться в папке ресурсов Electron (в macOS это
`Electron.app/Contents/Resources/`, в Linux и Windows - `resources/`),
вот так:
Для OS X:
Для macOS:
```text
electron/Electron.app/Contents/Resources/app/
@ -38,7 +38,7 @@ electron/resources/app
после чего Electron попробует считать ресурсы и запустить архив.
Для OS X:
Для macOS:
```text
electron/Electron.app/Contents/Resources/
@ -64,7 +64,7 @@ electron/resources/
Вы можете переименовать `electron.exe` как пожелаете и поменять иконку и прочую
информацию приложениями вроде [rcedit](https://github.com/atom/rcedit).
### OS X
### macOS
Вы можете переименовать `Electron.app` как пожелаете, а также изменить
поля `CFBundleDisplayName`, `CFBundleIdentifier` и `CFBundleName` в следующих

View file

@ -85,7 +85,7 @@
productbuild --component "$APP_PATH" /Applications --sign "$INSTALLER_KEY" "$RESULT_PATH"
```
Если вы только начали разрабатывать под Mac OS X, то мы советуем Вам прочитать [App SandBox](https://developer.apple.com/library/ios/documentation/Miscellaneous/Reference/EntitlementKeyReference/Chapters/EnablingAppSandbox.html "Ссылка для новичков в разработке приложений для Mac OS X")
Если вы только начали разрабатывать под macOS, то мы советуем Вам прочитать [App SandBox](https://developer.apple.com/library/ios/documentation/Miscellaneous/Reference/EntitlementKeyReference/Chapters/EnablingAppSandbox.html "Ссылка для новичков в разработке приложений для macOS")
## Обновление приложения

View file

@ -113,7 +113,7 @@ app.on('ready', createWindow)
// Выйти, если все окна закрыты
app.on('window-all-closed', function () {
//На OS X приложение и его строка меню обычно остаются активными,
//На macOS приложение и его строка меню обычно остаются активными,
//пока пользователь не завершит их с помощью `Cmd + Q`.
if (process.platform !== 'darwin') {
app.quit()
@ -121,7 +121,7 @@ app.on('window-all-closed', function () {
})
app.on('activate', function () {
//На OS X приложение обычно пересоздаёт окно, когда
//На macOS приложение обычно пересоздаёт окно, когда
//пользователь кликает на его иконку в доке, если не открыто
//других окон.
if (mainWindow === null) {
@ -192,7 +192,7 @@ $ .\electron\electron.exe your-app\
$ ./electron/electron your-app/
```
#### OS X
#### macOS
```bash
$ ./Electron.app/Contents/MacOS/Electron your-app/

View file

@ -2,9 +2,9 @@
Следующие платформы поддерживаются Electron:
### OS X
### macOS
Поддерживает только 64-x битные OS X. Минимально поддерживаемой версией является OS X 10.9
Поддерживает только 64-x битные macOS. Минимально поддерживаемой версией является macOS 10.9
### Windows

View file

@ -66,7 +66,7 @@
* [โครงสร้างไดเรคทอรี่ของซอร์สโค้ด](development/source-code-directory-structure.md)
* [ความแตกต่างทางเทคนิคจาก NW.js (หรือ node-webkit)](development/atom-shell-vs-node-webkit.md)
* [ภาพรวมการสร้างระบบ](development/build-system-overview.md)
* [ขั้นตอนการสร้าง (OS X)](development/build-instructions-osx.md)
* [ขั้นตอนการสร้าง (macOS)](development/build-instructions-osx.md)
* [ขั้นตอนการสร้าง (Windows)](development/build-instructions-windows.md)
* [ขั้นตอนการสร้าง (Linux)](development/build-instructions-linux.md)
* [Setting Up Symbol Server in debugger](development/setting-up-symbol-server.md)

View file

@ -79,7 +79,7 @@ Bir problem(issue) bildirmeden önce sıkça sorulan sorulara göz atın:
* [Kaynak Kod Dizin Yapısı](https://github.com/electron/electron/tree/master/docs/development/source-code-directory-structure.md)
* [NW.js(node-webkit adıyla bilinen) İle Arasındaki Teknik Farklılıklar](https://github.com/electron/electron/tree/master/docs/development/atom-shell-vs-node-webkit.md)
* [Build Sisyem Genel Bakış](https://github.com/electron/electron/tree/master/docs/development/build-system-overview.md)
* [(OS X) Build Komutları](https://github.com/electron/electron/tree/master/docs/development/build-instructions-osx.md)
* [(macOS) Build Komutları](https://github.com/electron/electron/tree/master/docs/development/build-instructions-osx.md)
* [(Windows) Build Komutları](https://github.com/electron/electron/tree/master/docs/development/build-instructions-windows.md)
* [(Linux) Build Komutları](https://github.com/electron/electron/tree/master/docs/development/build-instructions-linux.md)
* [(Windows) Hata Ayıklama Komutları](https://github.com/electron/electron/tree/master/docs/development/debug-instructions-windows.md)

View file

@ -12,10 +12,10 @@ Hızlandırıcılar `+` karakteriyle birden fazla niteleyici ile kombinlenebilir
## Platform bilgileri
Linux ve Windows'ta `Command` tuşu herhangi bir etki göstermez. Bunun yerine
`CommandOrControl` niteleyicisini kullanın. Bu işlem OS X'te `Command`,
`CommandOrControl` niteleyicisini kullanın. Bu işlem macOS'te `Command`,
Linux ve Windows'ta `Control` tuşunun işlevini sağlar. `Alt` ise tüm platformlarda mevcuttur.
`Super` tuşu Windows ve Linux'te `Windows` tuşuna, OS X'te ise `Cmd` tuşuna eşleştirilmiştir.
`Super` tuşu Windows ve Linux'te `Windows` tuşuna, macOS'te ise `Cmd` tuşuna eşleştirilmiştir.
## Mevcut düzenleyiciler

View file

@ -24,7 +24,7 @@ Electron Dokümantasyonunu geliştirmek için aşağıdaki yöntemleri takip edi
- Optional arguments are denoted when called out in list.
- Line length is 80-column wrapped.
- Platform specific methods are noted in italics following method header.
- ```### `method(foo, bar)` _OS X_```
- ```### `method(foo, bar)` _macOS_```
- Prefer 'in the ___ process' over 'on'
### Dokümantasyon Çevirisi

View file

@ -77,7 +77,7 @@
* [Source Code Directory Structure](development/source-code-directory-structure.md)
* [Technical Differences to NW.js (formerly node-webkit)](development/atom-shell-vs-node-webkit.md)
* [Build System Overview](development/build-system-overview.md)
* [Build Instructions (OS X)](development/build-instructions-osx.md)
* [Build Instructions (macOS)](development/build-instructions-osx.md)
* [Build Instructions (Windows)](development/build-instructions-windows.md)
* [Build Instructions (Linux)](development/build-instructions-linux.md)
* [Setting Up Symbol Server in debugger](development/setting-up-symbol-server.md)

View file

@ -24,7 +24,7 @@ or [writing Electron documentation](#writing-electron-documentation).
- Optional arguments are denoted when called out in list.
- Line length is 80-column wrapped.
- Platform specific methods are noted in italics following method header.
- ```### `method(foo, bar)` _OS X_```
- ```### `method(foo, bar)` _macOS_```
- Prefer 'in the ___ process' over 'on'
### Переклад документації

View file

@ -73,7 +73,7 @@
* [源码目录结构](development/source-code-directory-structure.md)
* [与 NW.js原 node-webkit在技术上的差异](development/atom-shell-vs-node-webkit.md)
* [构建系统概览](development/build-system-overview.md)
* [构建步骤(OS X](development/build-instructions-osx.md)
* [构建步骤(macOS](development/build-instructions-osx.md)
* [构建步骤Windows](development/build-instructions-windows.md)
* [构建步骤Linux](development/build-instructions-linux.md)
* [在调试中使用 Symbol Server](development/setting-up-symbol-server.md)

View file

@ -9,10 +9,10 @@
## 运行平台相关的提示
在 Linux 和 Windows 上,`Command` 键并不存在,因此我们通常用 `CommandOrControl` 来表示“在 OS X 下为 `Command` 键,但在
在 Linux 和 Windows 上,`Command` 键并不存在,因此我们通常用 `CommandOrControl` 来表示“在 macOS 下为 `Command` 键,但在
Linux 和 Windows 下为 `Control` 键。
`Super` 键是指 Linux 和 Windows 上的 `Windows` 键,但是在 OS X 下为 `Command` 键。
`Super` 键是指 Linux 和 Windows 上的 `Windows` 键,但是在 macOS 下为 `Command` 键。
## 可用的功能按键

View file

@ -18,7 +18,7 @@ app.on('window-all-closed', function() {
### 事件:'will-finish-launching'
当应用程序完成基础的启动的时候被触发。在 Windows 和 Linux 中,
`will-finish-launching` 事件与 `ready` 事件是相同的; 在 OS X 中,
`will-finish-launching` 事件与 `ready` 事件是相同的; 在 macOS 中,
这个时间相当于 `NSApplication` 中的 `applicationWillFinishLaunching` 提示。
你应该经常在这里为 `open-file``open-url` 设置监听器,并启动崩溃报告和自动更新。
@ -65,7 +65,7 @@ app.on('window-all-closed', function() {
当应用程序正在退出时触发。
### 事件:'open-file' _OS X_
### 事件:'open-file' _macOS_
返回:
@ -79,7 +79,7 @@ app.on('window-all-closed', function() {
如果你想处理这个事件,你应该调用 `event.preventDefault()`
在 Windows系统中, 你需要通过解析 process.argv 来获取文件路径。
### 事件:'open-url' _OS X_
### 事件:'open-url' _macOS_
返回:
@ -90,7 +90,7 @@ app.on('window-all-closed', function() {
如果你想处理这个事件,你应该调用 `event.preventDefault()`
### 事件:'activate' _OS X_
### 事件:'activate' _macOS_
返回:
@ -225,11 +225,11 @@ app.on('login', function(event, webContents, request, authInfo, callback) {
这个方法保证了所有的 `beforeunload``unload` 事件处理器被正确执行。假如一个窗口的 `beforeunload` 事件处理器返回 `false`,那么整个应用可能会取消退出。
### `app.hide()` _OS X_
### `app.hide()` _macOS_
隐藏所有的应用窗口,不是最小化.
### `app.show()` _OS X_
### `app.show()` _macOS_
隐藏后重新显示所有的窗口,不会自动选中他们。
@ -257,7 +257,7 @@ app.on('login', function(event, webContents, request, authInfo, callback) {
* `appData` 当前用户的应用数据文件夹,默认对应:
* `%APPDATA%` Windows 中
* `$XDG_CONFIG_HOME` or `~/.config` Linux 中
* `~/Library/Application Support` OS X
* `~/Library/Application Support` macOS 中
* `userData` 储存你应用程序设置文件的文件夹,默认是 `appData` 文件夹附加应用的名称
* `temp` 临时文件夹
* `exe` 当前的可执行文件
@ -305,15 +305,15 @@ app.on('login', function(event, webContents, request, authInfo, callback) {
返回当前应用程序的语言。
### `app.addRecentDocument(path)` _OS X_ _Windows_
### `app.addRecentDocument(path)` _macOS_ _Windows_
* `path` String
在最近访问的文档列表中添加 `path`
这个列表由操作系统进行管理。在 Windows 中您可以通过任务条进行访问,在 OS X 中你可以通过 dock 菜单进行访问。
这个列表由操作系统进行管理。在 Windows 中您可以通过任务条进行访问,在 macOS 中你可以通过 dock 菜单进行访问。
### `app.clearRecentDocuments()` _OS X_ _Windows_
### `app.clearRecentDocuments()` _macOS_ _Windows_
清除最近访问的文档列表。
@ -358,7 +358,7 @@ app.on('login', function(event, webContents, request, authInfo, callback) {
如果当前实例为第一个实例,那么在这个方法将会返回 `false` 来保证它继续运行。否则将会返回 `true` 来让它立刻退出。
在 OS X 中,如果用户通过 Finder、`open-file` 或者 `open-url` 打开应用,系统会强制确保只有一个实例在运行。但是如果用户是通过
macOS 中,如果用户通过 Finder、`open-file` 或者 `open-url` 打开应用,系统会强制确保只有一个实例在运行。但是如果用户是通过
命令行打开,这个系统机制会被忽略,所以你仍然需要靠这个方法来保证应用为单实例运行的。
下面是一个简单的例子。我们可以通过这个例子了解如何确保应用为单实例运行状态。
@ -432,7 +432,7 @@ if (browserOptions.transparent) {
**注意** 这个方法不会影响 `process.argv`
### `app.dock.bounce([type])` _OS X_
### `app.dock.bounce([type])` _macOS_
* `type` String - 可选参数,可以是 `critical``informational`。默认为 `informational`
@ -442,37 +442,37 @@ if (browserOptions.transparent) {
这个方法返回的返回值表示这个请求的 ID。
### `app.dock.cancelBounce(id)` _OS X_
### `app.dock.cancelBounce(id)` _macOS_
* `id` Integer
取消这个 `id` 对应的请求。
### `app.dock.setBadge(text)` _OS X_
### `app.dock.setBadge(text)` _macOS_
* `text` String
设置应用在 dock 中显示的字符串。
### `app.dock.getBadge()` _OS X_
### `app.dock.getBadge()` _macOS_
返回应用在 dock 中显示的字符串。
### `app.dock.hide()` _OS X_
### `app.dock.hide()` _macOS_
隐藏应用在 dock 中的图标。
### `app.dock.show()` _OS X_
### `app.dock.show()` _macOS_
显示应用在 dock 中的图标。
### `app.dock.setMenu(menu)` _OS X_
### `app.dock.setMenu(menu)` _macOS_
* `menu` [Menu](menu.md)
设置应用的 [dock 菜单][dock-menu].
### `app.dock.setIcon(image)` _OS X_
### `app.dock.setIcon(image)` _macOS_
* `image` [NativeImage](native-image.md)

View file

@ -6,9 +6,9 @@
虽然 `autoUpdater` 模块提供了一套各平台通用的接口,但是在每个平台间依然会有一些微小的差异。
### OS X
### macOS
在 OS X 上,`autoUpdater` 模块依靠的是内置的 [Squirrel.Mac][squirrel-mac],这意味着你不需要依靠其他的设置就能使用。关于
macOS 上,`autoUpdater` 模块依靠的是内置的 [Squirrel.Mac][squirrel-mac],这意味着你不需要依靠其他的设置就能使用。关于
更新服务器的配置,你可以通过阅读 [Server Support][server-support] 这篇文章来了解。
### Windows
@ -19,7 +19,7 @@ Squirrel 自动生成的安装向导会生成一个带 [Application User Model I
Application User Model ID 的格式是 `com.squirrel.PACKAGE_ID.YOUR_EXE_WITHOUT_DOT_EXE`, 比如
`com.squirrel.slack.Slack``com.squirrel.code.Code` 这样的。你应该在自己的应用中使用 `app.setAppUserModelId` 方法设置相同的 API不然 Windows 将不能正确地把你的应用固定在任务栏上。
服务器端的配置和 OS X 也是不一样的,你可以阅读 [Squirrel.Windows][squirrel-windows] 这个文档来获得详细信息。
服务器端的配置和 macOS 也是不一样的,你可以阅读 [Squirrel.Windows][squirrel-windows] 这个文档来获得详细信息。
### Linux

View file

@ -47,8 +47,8 @@ win.show();
* `maximizable` Boolean - 窗口是否可以最大化. 在 Linux 上无效. 默认为 `true`.
* `closable` Boolean - 窗口是否可以关闭. 在 Linux 上无效. 默认为 `true`.
* `alwaysOnTop` Boolean - 窗口是否总是显示在其他窗口之前. 在 Linux 上无效. 默认为 `false`.
* `fullscreen` Boolean - 窗口是否可以全屏幕. 当明确设置值为When `false` ,全屏化按钮将会隐藏,在 OS X 将禁用. 默认 `false`.
* `fullscreenable` Boolean - 在 OS X 上,全屏化按钮是否可用,默认为 `true`.
* `fullscreen` Boolean - 窗口是否可以全屏幕. 当明确设置值为When `false` ,全屏化按钮将会隐藏,在 macOS 将禁用. 默认 `false`.
* `fullscreenable` Boolean - 在 macOS 上,全屏化按钮是否可用,默认为 `true`.
* `skipTaskbar` Boolean - 是否在任务栏中显示窗口. 默认是`false`.
* `kiosk` Boolean - kiosk 方式. 默认为 `false`.
* `title` String - 窗口默认title. 默认 `"Electron"`.
@ -62,7 +62,7 @@ win.show();
* `enableLargerThanScreen` Boolean - 是否允许允许改变窗口大小大于屏幕. 默认是 `false`.
* `backgroundColor` String -窗口的 background color 值为十六进制,如 `#66CD00``#FFF``#80FFFFFF` (支持透明度). 默认为在 Linux 和 Windows 上为
`#000` (黑色) , Mac上为 `#FFF`(或透明).
* `hasShadow` Boolean - 窗口是否有阴影. 只在 OS X 上有效. 默认为 `true`.
* `hasShadow` Boolean - 窗口是否有阴影. 只在 macOS 上有效. 默认为 `true`.
* `darkTheme` Boolean - 为窗口使用 dark 主题, 只在一些拥有 GTK+3 桌面环境上有效. 默认为 `false`.
* `transparent` Boolean - 窗口 [透明](frameless-window.md).
默认为 `false`.
@ -74,13 +74,13 @@ win.show();
* Linux, 可用值为 `desktop`, `dock`, `toolbar`, `splash`,
`notification`.
* OS X, 可用值为 `desktop`, `textured`.
* macOS, 可用值为 `desktop`, `textured`.
* `textured` type 添加金属梯度效果
(`NSTexturedBackgroundWindowMask`).
* `desktop` 设置窗口在桌面背景窗口水平
(`kCGDesktopWindowLevel - 1`). 注意桌面窗口不可聚焦, 不可不支持键盘和鼠标事件, 但是可以使用 `globalShortcut` 来解决输入问题.
`titleBarStyle` 只在 OS X 10.10 Yosemite 或更新版本上支持.
`titleBarStyle` 只在 macOS 10.10 Yosemite 或更新版本上支持.
可用值:
* `default` 以及无值, 显示在 Mac 标题栏上为不透明的标准灰色.
@ -206,9 +206,9 @@ window.onbeforeunload = function(e) {
在窗口移动的时候触发.
注意:在 OS X 中别名为 `moved`.
注意:在 macOS 中别名为 `moved`.
### Event: 'moved' _OS X_
### Event: 'moved' _macOS_
在窗口移动的时候触发.
@ -242,11 +242,11 @@ someWindow.on('app-command', function(e, cmd) {
});
```
### Event: 'scroll-touch-begin' _OS X_
### Event: 'scroll-touch-begin' _macOS_
在滚动条事件开始的时候触发.
### Event: 'scroll-touch-end' _OS X_
### Event: 'scroll-touch-end' _macOS_
在滚动条事件结束的时候触发.
@ -379,7 +379,7 @@ var win = new BrowserWindow({ width: 800, height: 600 });
返回 boolean, 窗口是否全屏化.
### `win.setAspectRatio(aspectRatio[, extraSize])` _OS X_
### `win.setAspectRatio(aspectRatio[, extraSize])` _macOS_
* `aspectRatio` 维持部分视图内容窗口的高宽比值.
* `extraSize` Object (可选) - 维持高宽比值时不包含的额外size.
@ -398,7 +398,7 @@ var win = new BrowserWindow({ width: 800, height: 600 });
* `y` Integer
* `width` Integer
* `height` Integer
* `animate` Boolean (可选) _OS X_
* `animate` Boolean (可选) _macOS_
重新设置窗口的宽高值,并且移动到指定的 `x`, `y` 位置.
@ -410,7 +410,7 @@ var win = new BrowserWindow({ width: 800, height: 600 });
* `width` Integer
* `height` Integer
* `animate` Boolean (可选) _OS X_
* `animate` Boolean (可选) _macOS_
重新设置窗口的宽高值.
@ -422,7 +422,7 @@ var win = new BrowserWindow({ width: 800, height: 600 });
* `width` Integer
* `height` Integer
* `animate` Boolean (可选) _OS X_
* `animate` Boolean (可选) _macOS_
重新设置窗口客户端的宽高值(例如网页界面).
@ -462,33 +462,33 @@ var win = new BrowserWindow({ width: 800, height: 600 });
返回 boolean,窗口是否可以被用户改变size.
### `win.setMovable(movable)` _OS X_ _Windows_
### `win.setMovable(movable)` _macOS_ _Windows_
* `movable` Boolean
设置窗口是否可以被用户拖动. Linux 无效.
### `win.isMovable()` _OS X_ _Windows_
### `win.isMovable()` _macOS_ _Windows_
返回 boolean,窗口是否可以被用户拖动. Linux 总是返回 `true`.
### `win.setMinimizable(minimizable)` _OS X_ _Windows_
### `win.setMinimizable(minimizable)` _macOS_ _Windows_
* `minimizable` Boolean
设置窗口是否可以最小化. Linux 无效.
### `win.isMinimizable()` _OS X_ _Windows_
### `win.isMinimizable()` _macOS_ _Windows_
返回 boolean,窗口是否可以最小化. Linux 总是返回 `true`.
### `win.setMaximizable(maximizable)` _OS X_ _Windows_
### `win.setMaximizable(maximizable)` _macOS_ _Windows_
* `maximizable` Boolean
设置窗口是否可以最大化. Linux 无效.
### `win.isMaximizable()` _OS X_ _Windows_
### `win.isMaximizable()` _macOS_ _Windows_
返回 boolean,窗口是否可以最大化. Linux 总是返回 `true`.
@ -502,13 +502,13 @@ var win = new BrowserWindow({ width: 800, height: 600 });
返回 boolean,点击最大化按钮是否可以全屏或最大化窗口.
### `win.setClosable(closable)` _OS X_ _Windows_
### `win.setClosable(closable)` _macOS_ _Windows_
* `closable` Boolean
设置窗口是否可以人为关闭. Linux 无效.
### `win.isClosable()` _OS X_ _Windows_
### `win.isClosable()` _macOS_ _Windows_
返回 boolean,窗口是否可以人为关闭. Linux 总是返回 `true`.
@ -530,7 +530,7 @@ var win = new BrowserWindow({ width: 800, height: 600 });
* `x` Integer
* `y` Integer
* `animate` Boolean (可选) _OS X_
* `animate` Boolean (可选) _macOS_
移动窗口到对应的 `x` and `y` 坐标.
@ -576,7 +576,7 @@ var win = new BrowserWindow({ width: 800, height: 600 });
`Buffer` 形式返回这个具体平台的窗口的句柄.
windows上句柄类型为 `HWND` OS X `NSView*` Linux `Window`.
windows上句柄类型为 `HWND` macOS `NSView*` Linux `Window`.
### `win.hookWindowMessage(message, callback)` _Windows_
@ -601,23 +601,23 @@ windows上句柄类型为 `HWND` OS X `NSView*` Linux `Window`.
窗口消息全部不拦截.
### `win.setRepresentedFilename(filename)` _OS X_
### `win.setRepresentedFilename(filename)` _macOS_
* `filename` String
设置窗口当前文件路径,并且将这个文件的图标放在窗口标题栏上.
### `win.getRepresentedFilename()` _OS X_
### `win.getRepresentedFilename()` _macOS_
获取窗口当前文件路径.
### `win.setDocumentEdited(edited)` _OS X_
### `win.setDocumentEdited(edited)` _macOS_
* `edited` Boolean
明确指出窗口文档是否可以编辑,如果可以编辑则将标题栏的图标变成灰色.
### `win.isDocumentEdited()` _OS X_
### `win.isDocumentEdited()` _macOS_
返回 boolean,当前窗口文档是否可编辑.
@ -668,13 +668,13 @@ windows上句柄类型为 `HWND` OS X `NSView*` Linux `Window`.
向当前任务栏添加一个 16 x 16 像素的图标,通常用来覆盖一些应用的状态,或者直接来提示用户.
### `win.setHasShadow(hasShadow)` _OS X_
### `win.setHasShadow(hasShadow)` _macOS_
* `hasShadow` (Boolean)
设置窗口是否应该有阴影.在Windows和Linux系统无效.
### `win.hasShadow()` _OS X_
### `win.hasShadow()` _macOS_
返回 boolean,设置窗口是否有阴影.在Windows和Linux系统始终返回
`true`.
@ -704,7 +704,7 @@ windows上句柄类型为 `HWND` OS X `NSView*` Linux `Window`.
* `hidden` - button 对用户不可见.
* `noninteractive` - button 可用但是不可响应; 也不显示按下的状态. 它的值意味着这是一个在通知单使用 button 的实例.
### `win.showDefinitionForSelection()` _OS X_
### `win.showDefinitionForSelection()` _macOS_
在界面查找选中文字时显示弹出字典.
@ -744,7 +744,7 @@ windows上句柄类型为 `HWND` OS X `NSView*` Linux `Window`.
**注意:** 在 windows上始终返回 false.
### `win.setIgnoreMouseEvents(ignore)` _OS X_
### `win.setIgnoreMouseEvents(ignore)` _macOS_
* `ignore` Boolean

Some files were not shown because too many files have changed in this diff Show more