Plusb Preco f05fc3c0ea Improve grammar, some fixes

* Improve grammar
* Fix typos
* Fix some mistranslations
* Fix quotes (' to `)

2015-10-16 22:23:31 +09:00

13 KiB

Raw Blame History

app

app 모듈은 어플리케이션의 생명주기 제어를 책임집니다.

밑의 예제는 마지막 윈도우창가 종료되었을 때, 어플리케이션을 종료시키는 예제입니다:

var app = require('app');
app.on('window-all-closed', function() {
  app.quit();
});

Events

app 객체는 다음과 같은 이벤트를 가지고 있습니다:

Event: 'will-finish-launching'

어플리케이션이 기본적인 시작 준비를 마치면 발생하는 이벤트입니다. Windows, Linux 운영체제에서의 will-finish-launching 이벤트는 ready 이벤트와 동일합니다. OS X에서의 이벤트는 NSApplication의 applicationWillFinishLaunching에 대한 알림으로 표현됩니다. 대개 이곳에서 open-file과 open-url 이벤트 리스너를 설정하고 crash reporter와 auto updater를 시작합니다.

대부분의 경우, 모든 것을 ready 이벤트 핸들러로 해결해야 합니다.

Event: 'ready'

Electron이 초기화를 끝냈을 때 발생하는 이벤트입니다.

Event: 'window-all-closed'

모든 윈도우창이 종료되었을 때 발생하는 이벤트입니다.

이 이벤트는 어플리케이션이 완전히 종료되지 않았을 때만 발생합니다. 만약 사용자가 Cmd + Q를 입력했거나 개발자가 app.quit()를 호출했다면, Electron은 먼저 모든 윈도우창의 종료를 시도하고 will-quit 이벤트를 발생시킵니다. 그리고 will-quit 이벤트가 발생했을 땐 window-all-closed 이벤트가 발생하지 않습니다.

역주: 이 이벤트는 말 그대로 현재 어플리케이션에서 윈도우창만 완전히 종료됬을 때 발생하는 이벤트 입니다. 따라서 어플리케이션을 완전히 종료하려면 이 이벤트에서 app.quit()를 호출해 주어야 합니다.

Event: 'before-quit'

Returns:

event Event

어플리케이션 윈도우창들이 닫히기 시작할 때 발생하는 이벤트입니다. event.preventDefault() 호출은 이벤트의 기본 동작을 방지하기 때문에 이를 통해 어플리케이션의 종료를 방지할 수 있습니다.

Event: 'will-quit'

Returns:

event Event

모든 윈도우창들이 종료되고 어플리케이션이 종료되기 시작할 때 발생하는 이벤트 입니다. event.preventDefault() 호출을 통해 어플리케이션의 종료를 방지할 수 있습니다.

will-quit 와 window-all-closed 이벤트의 차이점을 확인하려면 window-all-close 이벤트의 설명을 참고하세요.

Event: 'quit'

어플리케이션이 종료될 때 발생하는 이벤트입니다.

Event: 'open-file'

Returns:

event Event
path String

사용자가 어플리케이션을 통해 파일을 열고자 할 때 발생하는 이벤트입니다.

open-file 이벤트는 보통 어플리케이션이 열려 있을 때와 OS가 파일을 열기 위해 어플리케이션을 재사용할 때 발생합니다. open-file 이벤트는 파일을 dock에 떨어트릴 때와 어플리케이션이 실행되기 전에도 발생합니다. 이 경우엔 확실히 open-file 이벤트 리스너를 어플리케이션이 시작하기 전에 설정해 놓았는지 확인해야 합니다. (ready 이벤트가 발생하기 전에)

이 이벤트를 처리하려면 반드시 event.preventDefault()를 호출해야 합니다.

Event: 'open-url'

Returns:

event Event
url String

유저가 어플리케이션을 통해 URL을 열고자 할 때 발생하는 이벤트입니다.

어플리케이션에서 URL을 열기 위해선 반드시 URL 스킴이 등록되어 있어야 합니다.

이 이벤트를 처리하려면 반드시 event.preventDefault()를 호출해야 합니다.

Event: 'activate' OS X

Returns:

event Event
hasVisibleWindows Bool

어플리케이션이 활성화 되었을 때 발생하는 이벤트 입니다. 이 이벤트는 어플리케이션의 dock 아이콘을 클릭했을 때 주로 발생합니다.

Event: 'browser-window-blur'

Returns:

event Event
window BrowserWindow

browserWindow에 대한 포커스가 사라졌을 때 발생하는 이벤트 입니다.

Event: 'browser-window-focus'

Returns:

event Event
window BrowserWindow

browserWindow에 대한 포커스가 발생했을 때 발생하는 이벤트 입니다.

역주: _포커스_는 창을 클릭해서 활성화 시켰을 때를 말합니다.

Event: 'browser-window-created'

Returns:

event Event
window BrowserWindow

새로운 browserWindow가 생성되었을 때 발생하는 이벤트 입니다.

Event: 'select-certificate'

사용자 인증이 요청되었을 때 발생하는 이벤트 입니다.

Returns:

event Event
webContents WebContents
url String
certificateList [Objects]
- data PEM으로 인코딩된 데이터
- issuerName 발급자의 공통 이름
callback Function

app.on('select-certificate', function(event, host, url, list, callback) {
  event.preventDefault();
  callback(list[0]);
})

url에 대한

url은 클라이언트 인증서를 요청하는 탐색 항목에 해당합니다. 그리고 callback은 목록에서 필터링된 항목과 함께 호출될 필요가 있습니다.

이 이벤트에서의 event.preventDefault() 호출은 초기 인증에 사용한 저장된 데이터를 사용하는 것을 막습니다.

Event: 'gpu-process-crashed'

GPU가 작동하던 중 크래시가 일어났을 때 발생하는 이벤트입니다.

Methods

app 객체는 다음과 같은 메서드를 가지고 있습니다:

참고: 몇몇 메서드는 특정 플랫폼에서만 작동합니다.

`app.quit()`

모든 윈도우창 종료를 시도합니다. before-quit 이벤트가 먼저 발생합니다. 모든 윈도우창이 성공적으로 종료되면 will-quit 이벤트가 발생하고 기본 동작에 따라 어플리케이션이 종료됩니다.

이 함수는 모든 beforeunload와 unload 이벤트 핸들러가 제대로 실행됨을 보장합니다. beforeunload 이벤트 핸들러에서 false를 반환했을 때 윈도우창 종료가 취소 될 수 있습니다.

`app.getAppPath()`

현재 어플리케이션의 디렉터리를 반환합니다.

`app.getPath(name)`

name String

name에 관련한 특정 디렉터리 또는 파일의 경로를 반환합니다. 경로를 가져오는 데 실패할 경우 Error를 반환합니다.

역주: 이 메서드는 운영체제에서 지정한 특수 디렉터리를 가져오는데 사용할 수 있습니다.

name은 다음 목록에 있는 경로 중 하나를 선택해 사용할 수 있습니다:

home - 사용자의 홈 디렉터리.
appData - 각 사용자의 어플리케이션 데이터 디렉터리. 기본 경로는 다음과 같습니다:
- %APPDATA% - Windows
- $XDG_CONFIG_HOME 또는 ~/.config - Linux
- ~/Library/Application Support - OS X
userData - 어플리케이션의 설정을 저장하는 디렉터리. 이 디렉터리는 기본적으로 appData에 어플리케이션 이름으로 생성된 폴더가 지정됩니다.
temp - 임시 폴더 디렉터리.
userDesktop - 현재 사용자의 데스트탑 디렉터리.
exe - 현재 실행중인 Electron 바이너리 파일.
module - libchromiumcontent 라이브러리.

`app.setPath(name, path)`

name String
path String

name에 대한 특정 디렉터리나 파일의 경로인 path를 재정의합니다. 만약 지정한 디렉터리의 경로가 존재하지 않으면 디렉터리가 이 메서드를 통해 새로 생성됩니다. 재정의에 실패했을 땐 Error를 반환합니다.

이 메서드는 app.getPath에 정의되어 있는 name의 경로만 재정의할 수 있습니다.

기본적으로, 웹 페이지의 쿠키와 캐시는 userData 디렉터리에 저장됩니다. 만약 이 위치를 변경하고자 한다면, 반드시 app 모듈의 ready 이벤트가 발생하기 전에 userData 경로를 재정의해야 합니다.

`app.getVersion()`

로드된 어플리케이션의 버전을 반환합니다.

만약 package.json 파일에서 어플리케이션의 버전을 찾을 수 없는 경우, 현재 번들 또는 실행 파일의 버전을 반환합니다.

`app.getName()`

package.json에서 기술된 현재 어플리케이션의 이름을 반환합니다.

npm 모듈 규칙에 따라 대부분의 경우 package.json의 name 필드는 소문자 이름을 사용합니다. 하지만 Electron은 name대신 productName 필드를 주로 사용하기 때문에 반드시 이 필드도 같이 지정해야 합니다. 이 필드는 맨 앞글자가 대문자인 어플리케이션 전체 이름을 지정해야 합니다.

`app.getLocale()`

현재 어플리케이션의 로케일을 반환합니다.

`app.resolveProxy(url, callback)`

url URL
callback Function

url의 프록시 정보를 해석합니다. callback은 요청이 수행되었을 때 callback(proxy) 형태로 호출됩니다.

`app.addRecentDocument(path)`

path String

최근 문서 목록에 path를 추가합니다.

이 목록은 OS에 의해 관리됩니다. 최근 문서 목록은 Windows의 경우 작업 표시줄에서 찾을 수 있고, OS X의 경우 dock 메뉴에서 찾을 수 있습니다.

`app.clearRecentDocuments()`

최근 문서 목록을 모두 비웁니다.

`app.setUserTasks(tasks)` Windows

tasks Array - Task 객체의 배열

Windows에서 사용할 수 있는 JumpList의 Tasks 카테고리에 task를 추가합니다.

tasks는 다음과 같은 구조를 가지는 Task 객체의 배열입니다:

Task Object

program String - 실행할 프로그램의 경로. 보통 현재 작동중인 어플리케이션의 경로인 process.execPath를 지정합니다.
arguments String - program이 실행될 때 사용될 명령줄 인자.
title String - JumpList에 표시할 문자열.
description String - 이 작업에 대한 설명.
iconPath String - JumpList에 표시될 아이콘의 절대 경로. 아이콘을 포함하고 있는 임의의 리소스 파일을 사용할 수 있습니다. 보통 어플리케이션의 아이콘을 그대로 사용하기 위해 process.execPath를 지정합니다.
iconIndex Integer - 아이콘 파일의 인덱스. 만약 아이콘 파일이 두 개 이상의 아이콘을 가지고 있을 경우, 사용할 아이콘의 인덱스를 이 옵션으로 지정해 주어야 합니다. 단, 아이콘을 하나만 포함하고 있는 경우 0을 지정하면 됩니다.

`app.commandLine.appendSwitch(switch[, value])`

Chrominum의 명령줄에 스위치를 추가합니다. value는 추가적인 값을 뜻하며 옵션입니다.

참고: 이 메서드는 process.argv에 영향을 주지 않습니다. 개발자들은 보통 Chrominum의 로우 레벨 수준의 동작을 제어하기 위해 주로 사용합니다.

`app.commandLine.appendArgument(value)`

Chrominum의 명령줄에 인자를 추가합니다. 인자는 올바르게 인용됩니다.

참고: 이 메서드는 process.argv에 영향을 주지 않습니다.

`app.dock.bounce([type])` OS X

type String (optional) - critical 또는 informational을 지정할 수 있습니다. 기본값은 informational 입니다.

critical이 전달되면 dock 아이콘이 어플리케이션이 활성화되거나 요청이 중지되기 전까지 통통 튑니다.

informational이 전달되면 dock 아이콘이 1초만 통통 튑니다. 하지만 어플리케이션이 활성화되거나 요청이 중지되기 전까지 요청은 계속 활성화로 유지 됩니다.

또한 요청을 취소할 때 사용할 수 있는 ID를 반환합니다.

`app.dock.cancelBounce(id)` OS X

id Integer

app.dock.bounce([type]) 메서드에서 반환한 id의 통통 튀는 효과를 취소합니다.

`app.dock.setBadge(text)` OS X

text String

dock의 badge에 표시할 문자열을 설정합니다.

`app.dock.getBadge()` OS X

dock의 badge에 설정된 문자열을 반환합니다.

`app.dock.hide()` OS X

dock 아이콘을 숨깁니다.

`app.dock.show()` OS X

dock 아이콘을 표시합니다.

`app.dock.setMenu(menu)` OS X

menu Menu

어플리케이션의 dock menu를 설정합니다.

13 KiB Raw Blame History

app

Events

Event: 'will-finish-launching'

Event: 'ready'

Event: 'window-all-closed'

Event: 'before-quit'

Event: 'will-quit'

Event: 'quit'

Event: 'open-file'

Event: 'open-url'

Event: 'activate' OS X

Event: 'browser-window-blur'

Event: 'browser-window-focus'

Event: 'browser-window-created'

Event: 'select-certificate'

Event: 'gpu-process-crashed'

Methods

app.quit()

app.getAppPath()

app.getPath(name)

app.setPath(name, path)

app.getVersion()

app.getName()

app.getLocale()

app.resolveProxy(url, callback)

app.addRecentDocument(path)

app.clearRecentDocuments()

app.setUserTasks(tasks) Windows

app.commandLine.appendSwitch(switch[, value])

app.commandLine.appendArgument(value)

app.dock.bounce([type]) OS X

app.dock.cancelBounce(id) OS X

app.dock.setBadge(text) OS X

app.dock.getBadge() OS X

app.dock.hide() OS X

app.dock.show() OS X

app.dock.setMenu(menu) OS X

13 KiB

Raw Blame History

`app.quit()`

`app.getAppPath()`

`app.getPath(name)`

`app.setPath(name, path)`

`app.getVersion()`

`app.getName()`

`app.getLocale()`

`app.resolveProxy(url, callback)`

`app.addRecentDocument(path)`

`app.clearRecentDocuments()`

`app.setUserTasks(tasks)` Windows

`app.commandLine.appendSwitch(switch[, value])`

`app.commandLine.appendArgument(value)`

`app.dock.bounce([type])` OS X

`app.dock.cancelBounce(id)` OS X

`app.dock.setBadge(text)` OS X

`app.dock.getBadge()` OS X

`app.dock.hide()` OS X

`app.dock.show()` OS X

`app.dock.setMenu(menu)` OS X