Merge pull request #6125 from leo/master
Replace "Mac OS" and "OS X" with "macOS"
This commit is contained in:
commit
78193a0608
157 changed files with 650 additions and 650 deletions
|
@ -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:` 코드 또는 파일을 삭제했을 때
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -22,7 +22,7 @@ Electron에 대한 중요한 알림을 받고 싶다면 Twitter에서
|
|||
|
||||
## 다운로드
|
||||
|
||||
Linux, Windows, OS X 용으로 미리 빌드된 Electron 바이너리와 디버그 심볼이 준비되어
|
||||
Linux, Windows, macOS 용으로 미리 빌드된 Electron 바이너리와 디버그 심볼이 준비되어
|
||||
있습니다. [releases](https://github.com/electron/electron/releases) 페이지에서
|
||||
받아 볼 수 있습니다.
|
||||
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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++) {
|
||||
|
|
|
@ -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,
|
||||
|
|
|
@ -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_;
|
||||
|
||||
|
|
|
@ -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);
|
||||
}
|
||||
|
|
|
@ -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];
|
||||
|
|
|
@ -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.
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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);
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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.
|
||||
|
|
|
@ -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' ],
|
||||
},
|
||||
|
|
|
@ -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
|
||||
|
||||
|
|
|
@ -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
|
||||
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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/
|
||||
|
|
|
@ -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.
|
||||
|
||||
|
|
|
@ -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/
|
||||
|
|
|
@ -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
|
||||
|
||||
|
|
|
@ -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');
|
||||
|
||||
|
|
|
@ -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)
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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)
|
||||
|
|
|
@ -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` キーに関連付けられます。
|
||||
|
||||
## 提供されている修飾語句
|
||||
|
||||
|
|
|
@ -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)
|
||||
|
||||
|
|
|
@ -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
|
||||
|
||||
|
|
|
@ -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()`
|
||||
|
||||
|
|
|
@ -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
|
||||
|
||||
|
|
|
@ -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' });
|
||||
|
|
|
@ -38,7 +38,7 @@
|
|||
* `minimize` - 現在のウィンドウの最小化
|
||||
* `close` - 現在のウィンドウを閉じます
|
||||
|
||||
OS Xでは、`role`は次の追加の値を取れます:
|
||||
macOSでは、`role`は次の追加の値を取れます:
|
||||
|
||||
* `about` - `orderFrontStandardAboutPanel`動作に紐づけられます
|
||||
* `hide` - `hide`動作に紐づけられます
|
||||
|
|
|
@ -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] を見てください。
|
||||
|
||||
## メニューアイテムの位置
|
||||
|
||||
|
|
|
@ -66,7 +66,7 @@ var appIcon = new Tray('/Users/somebody/images/icon.png');
|
|||
もっとも一般的なケースは、ライトとダークなメニュバー両方に切り替え可能なメニュバーアイコン用にテンプレート画像を使います。
|
||||
|
||||
|
||||
**Note:** テンプレート画像は、OS Xでのみサポートしています。
|
||||
**Note:** テンプレート画像は、macOSでのみサポートしています。
|
||||
|
||||
テンプレート画像として画像をマークするために、ファイル名の最後に`Template`をつけます。
|
||||
|
||||
|
|
|
@ -72,7 +72,7 @@ Windows Store App (appx)として動作中の場合は、値は`true`になり
|
|||
|
||||
このプロセスのメインスレッドをハングさせます。
|
||||
|
||||
### `process.setFdLimit(maxDescriptors)` _OS X_ _Linux_
|
||||
### `process.setFdLimit(maxDescriptors)` _macOS_ _Linux_
|
||||
|
||||
* `maxDescriptors` Integer
|
||||
|
||||
|
|
|
@ -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) - ポップアップ位置
|
||||
|
|
|
@ -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`のフィールドの名前を変更する必要があります。
|
||||
|
||||
|
|
|
@ -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-クリックをすると、パスがポップアップ表示されます。
|
||||
|
||||
ウィンドウの編集状態を設定できるように、このウィンドウのドキュメントが変更されたかどうかをファイルのアイコンで示せます。
|
||||
|
||||
|
|
|
@ -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をアップロードする。
|
||||
|
||||
|
|
|
@ -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/
|
||||
|
|
|
@ -2,9 +2,9 @@
|
|||
|
||||
Electronでは次のプラットフォームをサポートします。
|
||||
|
||||
### OS X
|
||||
### macOS
|
||||
|
||||
OS X用に提供しているバイナリは64bitのみで、サポートするOS Xのバージョンは、OS X 10.9 以降です。
|
||||
macOS用に提供しているバイナリは64bitのみで、サポートするmacOSのバージョンは、macOS 10.9 以降です。
|
||||
|
||||
### Windows
|
||||
|
||||
|
|
|
@ -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');
|
||||
|
||||
|
|
|
@ -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');
|
||||
|
|
|
@ -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)
|
||||
|
|
|
@ -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`키로 맵핑됩니다.
|
||||
|
||||
## 사용 가능한 혼합키
|
||||
|
||||
|
|
|
@ -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)
|
||||
|
||||
|
|
|
@ -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`을 설정하고 자동 업데이터를 초기화합니다.
|
||||
|
||||
|
|
|
@ -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()`와 같습니다.
|
||||
|
||||
|
|
|
@ -39,7 +39,7 @@ crashReporter.start({
|
|||
|
||||
다른 crashReporter API를 사용하기 전에 이 메서드를 먼저 호출해야 합니다.
|
||||
|
||||
**참고:** OS X에선 Windows와 Linux의 `breakpad`와 달리 새로운 `crashpad`
|
||||
**참고:** macOS에선 Windows와 Linux의 `breakpad`와 달리 새로운 `crashpad`
|
||||
클라이언트를 사용합니다. 오류 수집 기능을 활성화 시키려면 오류를 수집하고 싶은 메인
|
||||
프로세스나 렌더러 프로세스에서 `crashReporter.start` 메서드를 호출하여 `crashpad`를
|
||||
초기화해야 합니다.
|
||||
|
|
|
@ -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` 객체 참조를 전달하면 대화
|
||||
상자가 해당 윈도우에 시트처럼 표시되도록 표현할 수 있습니다. 윈도우의 객체 참조가
|
||||
제공되지 않으면 모달 형태로 표시됩니다.
|
||||
|
||||
|
|
|
@ -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)에선 네이티브 창에서 보여지는 그림자가 투명한 창에선 보이지 않습니다.
|
||||
|
||||
## 클릭이 통과될 수 있는 윈도우
|
||||
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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] 문서를 참고하세요.
|
||||
|
||||
|
|
|
@ -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` 인스턴스가 확실하게 유지되고 있는지를 인지해야
|
||||
|
|
|
@ -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
|
||||
|
||||
|
|
|
@ -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`입니다.
|
||||
|
||||
|
|
|
@ -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`
|
||||
|
|
|
@ -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) - 팝업 메뉴의 위치
|
||||
|
|
|
@ -944,7 +944,7 @@ win.webContents.on('did-finish-load', () => {
|
|||
});
|
||||
```
|
||||
|
||||
### `webContents.showDefinitionForSelection()` _OS X_
|
||||
### `webContents.showDefinitionForSelection()` _macOS_
|
||||
|
||||
페이지에서 선택된 단어에 대한 사전 검색 결과 팝업을 표시합니다.
|
||||
|
||||
|
|
|
@ -478,7 +478,7 @@ Service worker에 대한 개발자 도구를 엽니다.
|
|||
`event` 객체에 대해 자세히 알아보려면 [webContents.sendInputEvent](web-contents.md##webcontentssendinputeventevent)를
|
||||
참고하세요.
|
||||
|
||||
### `<webview>.showDefinitionForSelection()` _OS X_
|
||||
### `<webview>.showDefinitionForSelection()` _macOS_
|
||||
|
||||
페이지에서 선택된 단어에 대한 사전 검색 결과 팝업을 표시합니다.
|
||||
|
||||
|
|
|
@ -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비트는 지원할
|
||||
계획이 없습니다.
|
||||
|
||||
## 테스트
|
||||
|
|
|
@ -27,7 +27,7 @@ Electron 문서를 작성하는 규칙은 다음과 같습니다.
|
|||
- 선택적 인수는 목록에서 호출되면 표시합니다.
|
||||
- 문장의 길이는 한 줄당 80 칸을 유지합니다.
|
||||
- 플랫폼 특정 메서드 헤더는 이탈릭체로 표시합니다.
|
||||
- ```### `method(foo, bar)` _OS X_```
|
||||
- ```### `method(foo, bar)` _macOS_```
|
||||
- 'on' 표현 대신 'in the ___ process' 형식의 표현을 지향합니다.
|
||||
|
||||
### 번역된 참조 문서
|
||||
|
|
|
@ -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`
|
||||
|
|
|
@ -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 키를 누를 경우 파일 경로 팝업이 보여집니다. 또한
|
||||
창의 상태도 지정할 수 있습니다. 다시 말해 로드된 문서의 수정 여부를 제목의 파일
|
||||
아이콘에 표시할 수 있습니다.
|
||||
|
|
|
@ -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`
|
||||
|
|
|
@ -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) 파일에
|
||||
애플리케이션에서 요구하는 권한의 키를 추가합니다.
|
||||
|
||||
|
|
|
@ -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/
|
||||
|
|
|
@ -2,9 +2,9 @@
|
|||
|
||||
Electron에선 다음과 같은 플랫폼을 지원합니다:
|
||||
|
||||
### OS X
|
||||
### macOS
|
||||
|
||||
OS X는 64비트 바이너리만 제공됩니다. 그리고 최소 OS X 지원 버전은 10.9입니다.
|
||||
macOS는 64비트 바이너리만 제공됩니다. 그리고 최소 macOS 지원 버전은 10.9입니다.
|
||||
|
||||
### Windows
|
||||
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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');
|
||||
|
||||
|
|
|
@ -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');
|
||||
|
|
|
@ -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
|
||||
|
||||
|
|
|
@ -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
|
||||
|
||||
|
|
|
@ -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
|
||||
|
||||
|
|
|
@ -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.
|
||||
|
||||
|
|
|
@ -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
|
||||
|
||||
|
|
|
@ -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
|
||||
|
||||
|
|
|
@ -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`
|
||||
|
|
|
@ -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.
|
||||
|
||||
|
|
|
@ -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/
|
||||
|
|
|
@ -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)
|
||||
|
|
|
@ -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');
|
||||
|
||||
|
|
|
@ -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)
|
||||
|
|
|
@ -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` в следующих
|
||||
|
|
|
@ -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")
|
||||
|
||||
## Обновление приложения
|
||||
|
||||
|
|
|
@ -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/
|
||||
|
|
|
@ -2,9 +2,9 @@
|
|||
|
||||
Следующие платформы поддерживаются Electron:
|
||||
|
||||
### OS X
|
||||
### macOS
|
||||
|
||||
Поддерживает только 64-x битные OS X. Минимально поддерживаемой версией является OS X 10.9
|
||||
Поддерживает только 64-x битные macOS. Минимально поддерживаемой версией является macOS 10.9
|
||||
|
||||
### Windows
|
||||
|
||||
|
|
|
@ -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)
|
||||
|
|
|
@ -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)
|
||||
|
|
|
@ -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
|
||||
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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)
|
||||
|
|
|
@ -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'
|
||||
|
||||
### Переклад документації
|
||||
|
|
|
@ -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)
|
||||
|
|
|
@ -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` 键。
|
||||
|
||||
## 可用的功能按键
|
||||
|
||||
|
|
|
@ -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)
|
||||
|
||||
|
|
|
@ -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
|
||||
|
||||
|
|
|
@ -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
Loading…
Reference in a new issue