📝 Update Korean docs as upstream

[ci skip]
This commit is contained in:
Plusb Preco 2016-05-18 12:15:29 +09:00
parent ee9e28dfdf
commit 7fd3149031
9 changed files with 39 additions and 31 deletions

View file

@ -21,6 +21,7 @@ Electron에 대해 자주 묻는 질문이 있습니다. 이슈를 생성하기
* [지원하는 플랫폼](tutorial/supported-platforms.md) * [지원하는 플랫폼](tutorial/supported-platforms.md)
* [보안](tutorial/security.md) * [보안](tutorial/security.md)
* [Electron 버전 관리](tutorial/electron-versioning.md)
* [어플리케이션 배포](tutorial/application-distribution.md) * [어플리케이션 배포](tutorial/application-distribution.md)
* [Mac 앱스토어 어플리케이션 제출 가이드](tutorial/mac-app-store-submission-guide.md) * [Mac 앱스토어 어플리케이션 제출 가이드](tutorial/mac-app-store-submission-guide.md)
* [Windows 스토어 가이드](tutorial/windows-store-guide.md) * [Windows 스토어 가이드](tutorial/windows-store-guide.md)

View file

@ -24,7 +24,7 @@ Windows, Linux 운영체제에서의 `will-finish-launching` 이벤트는 `ready
`open-file``open-url` 이벤트 리스너를 설정하고 crash reporter와 auto updater를 `open-file``open-url` 이벤트 리스너를 설정하고 crash reporter와 auto updater를
시작합니다. 시작합니다.
대부분의 경우, 모든 것을 `ready` 이벤트 핸들러 해결해야 합니다. 대부분의 경우, 모든 것을 `ready` 이벤트 핸들러 안에서 해결해야 합니다.
### Event: 'ready' ### Event: 'ready'
@ -34,8 +34,9 @@ Electron이 초기화를 끝냈을 때 발생하는 이벤트입니다.
모든 윈도우가 종료되었을 때 발생하는 이벤트입니다. 모든 윈도우가 종료되었을 때 발생하는 이벤트입니다.
이 이벤트는 어플리케이션이 완전히 종료되지 않았을 때만 발생합니다. 만약 이 이벤트를 구독하지 않은 상태로 모든 윈도우가 닫혔을 때의 기본 동작은 앱을
만약 사용자가 `Cmd + Q`를 입력했거나 개발자가 `app.quit()`를 호출했다면, 종료하는 것입니다. 하지만, 이 이벤트를 구독하면, 앱을 종료할지 다른 일을 할지 제어할
수 있습니다. 만약 사용자가 `Cmd + Q`를 입력했거나 개발자가 `app.quit()`를 호출했다면,
Electron은 먼저 모든 윈도우의 종료를 시도하고 `will-quit` 이벤트를 발생시킵니다. Electron은 먼저 모든 윈도우의 종료를 시도하고 `will-quit` 이벤트를 발생시킵니다.
그리고 `will-quit` 이벤트가 발생했을 땐 `window-all-closed` 이벤트가 발생하지 그리고 `will-quit` 이벤트가 발생했을 땐 `window-all-closed` 이벤트가 발생하지
않습니다. 않습니다.
@ -63,7 +64,7 @@ Returns:
모든 윈도우들이 종료되고 어플리케이션이 종료되기 시작할 때 발생하는 이벤트입니다. 모든 윈도우들이 종료되고 어플리케이션이 종료되기 시작할 때 발생하는 이벤트입니다.
`event.preventDefault()` 호출을 통해 어플리케이션의 종료를 방지할 수 있습니다. `event.preventDefault()` 호출을 통해 어플리케이션의 종료를 방지할 수 있습니다.
`will-quit``window-all-closed` 이벤트의 차이점을 확인하려면 `window-all-close` `will-quit``window-all-closed` 이벤트의 차이점을 확인하려면 `window-all-closed`
이벤트의 설명을 참고하세요. 이벤트의 설명을 참고하세요.
### Event: 'quit' ### Event: 'quit'

View file

@ -34,6 +34,11 @@ Windows에선 `auto-updater` 모듈을 사용하기 전에 어플리케이션을
설치해야 합니다. [grunt-electron-installer][installer]를 사용하여 어플리케이션 설치해야 합니다. [grunt-electron-installer][installer]를 사용하여 어플리케이션
인스톨러를 만드는 것을 권장합니다. 인스톨러를 만드는 것을 권장합니다.
Windows에선 `autoUpdater` 모듈을 사용하기 전에 사용자의 장치에 어플리케이션을
설치해야 합니다. 따라서 [electron-winstaller][installer-lib] 모듈이나
[grunt-electron-installer][installer] 패키지를 사용하여 어플리케이션 인스톨러를
만드는 것을 권장합니다.
Squirrel로 생성된 인스톨러는 [Application User Model ID][app-user-model-id]와 함께 Squirrel로 생성된 인스톨러는 [Application User Model ID][app-user-model-id]와 함께
`com.squirrel.PACKAGE_ID.YOUR_EXE_WITHOUT_DOT_EXE`으로 형식화된 바로가기 아이콘을 `com.squirrel.PACKAGE_ID.YOUR_EXE_WITHOUT_DOT_EXE`으로 형식화된 바로가기 아이콘을
생성합니다. `com.squirrel.slack.Slack``com.squirrel.code.Code`가 그 예시입니다. 생성합니다. `com.squirrel.slack.Slack``com.squirrel.code.Code`가 그 예시입니다.
@ -108,6 +113,7 @@ Returns:
[server-support]: https://github.com/Squirrel/Squirrel.Mac#server-support [server-support]: https://github.com/Squirrel/Squirrel.Mac#server-support
[squirrel-windows]: https://github.com/Squirrel/Squirrel.Windows [squirrel-windows]: https://github.com/Squirrel/Squirrel.Windows
[installer]: https://github.com/electron/grunt-electron-installer [installer]: https://github.com/electron/grunt-electron-installer
[installer-lib]: https://github.com/electron/windows-installer
[app-user-model-id]: https://msdn.microsoft.com/en-us/library/windows/desktop/dd378459(v=vs.85).aspx [app-user-model-id]: https://msdn.microsoft.com/en-us/library/windows/desktop/dd378459(v=vs.85).aspx
[electron-release-server]: https://github.com/ArekSredzki/electron-release-server [electron-release-server]: https://github.com/ArekSredzki/electron-release-server
[squirrel-updates-server]: https://github.com/Aluxian/squirrel-updates-server [squirrel-updates-server]: https://github.com/Aluxian/squirrel-updates-server

View file

@ -50,8 +50,4 @@ Electron이 크래시되면, 크래시 정보 창을 표시합니다.
## `ELECTRON_FORCE_WINDOW_MENU_BAR` _Linux_ ## `ELECTRON_FORCE_WINDOW_MENU_BAR` _Linux_
Linux의 글로벌 메뉴 막대를 사용하지 않습니다. Linux의 전역 메뉴바를 사용하지 않습니다.
## `ELECTRON_HIDE_INTERNAL_MODULES`
`require('ipc')`같은 예전 방식의 빌트인 모듈을 비활성화합니다.

View file

@ -107,7 +107,7 @@ remote.getCurrentWindow().on('close', () => {
창을 새로고침 할 때마다 콜백을 새로 설치합니다. 게다가 이전 콜백이 제거되지 않고 창을 새로고침 할 때마다 콜백을 새로 설치합니다. 게다가 이전 콜백이 제거되지 않고
계속해서 쌓이면서 메모리 누수가 발생합니다. 계속해서 쌓이면서 메모리 누수가 발생합니다.
설상가상으로 이전에 등록된 콜백의 텍스트가 릴리즈 되고 난 후 (e.g. 페이지 새로고침) 설상가상으로 이전에 등록된 콜백의 텍스트가 릴리즈 되고 난 후 (e.g. 페이지 새로고침)
`close` 이벤트가 발생하면 예외가 발생하고 메인 프로세스가 작동 중지됩니다. `close` 이벤트가 발생하면 예외가 발생하고 메인 프로세스가 작동 중지됩니다.
이러한 문제를 피하려면 렌더러 프로세스에서 메인 프로세스로 넘긴 함수의 참조를 사용 후 이러한 문제를 피하려면 렌더러 프로세스에서 메인 프로세스로 넘긴 함수의 참조를 사용 후

View file

@ -71,25 +71,5 @@ const app = electron.app;
const BrowserWindow = electron.BrowserWindow; const BrowserWindow = electron.BrowserWindow;
``` ```
## 이전 스타일의 빌트인 모듈 비활성화
v0.35.0 이전 버전에선 빌트인 모듈이 모두 `require('module-name')`같은 형식으로
사용되었습니다. 하지만 [많은 단점][issue-387]이 있기 때문에 현재 API가 변경되었습니다.
하지만 오래된 앱의 호환성 유지를 위해 아직 구 버전 API를 지원하고 있습니다.
완벽하게 모든 구 버전 API를 비활성화하려면 `ELECTRON_HIDE_INTERNAL_MODULES` 환경
변수를 설정하면 됩니다:
```javascript
process.env.ELECTRON_HIDE_INTERNAL_MODULES = 'true'
```
또는 `hideInternalModules` API를 사용해도 됩니다:
```javascript
require('electron').hideInternalModules();
```
[gui]: https://en.wikipedia.org/wiki/Graphical_user_interface [gui]: https://en.wikipedia.org/wiki/Graphical_user_interface
[destructuring-assignment]: https://developer.mozilla.org/ko/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment [destructuring-assignment]: https://developer.mozilla.org/ko/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment
[issue-387]: https://github.com/electron/electron/issues/387

View file

@ -11,6 +11,8 @@
상호작용이 비동기로 작동한다는 것을 의미합니다. 따라서 임베디드 콘텐츠로부터 상호작용이 비동기로 작동한다는 것을 의미합니다. 따라서 임베디드 콘텐츠로부터
어플리케이션을 안전하게 유지할 수 있습니다. 어플리케이션을 안전하게 유지할 수 있습니다.
보안상의 이유로, `webview``nodeIntegration`이 활성화된 `BrowserWindow`에서만 사용할 수 있습니다.
## 예시 ## 예시
웹 페이지를 어플리케이션에 삽입하려면 `webview` 태그를 사용해 원하는 타겟 페이지에 웹 페이지를 어플리케이션에 삽입하려면 `webview` 태그를 사용해 원하는 타겟 페이지에

View file

@ -60,7 +60,7 @@ Electron
## Git 서브 모듈 최신 버전으로 유지 ## Git 서브 모듈 최신 버전으로 유지
Electron 저장소는 몇 가지 외부 벤더 종속성을 가지고 있으며 [/vendor](/vendor) Electron 저장소는 몇 가지 외부 벤더 종속성을 가지고 있으며 [/vendor][vendor]
디렉터리에서 확인할 수 있습니다. 때때로 `git status`를 실행했을 때 아마 다음과 같은 디렉터리에서 확인할 수 있습니다. 때때로 `git status`를 실행했을 때 아마 다음과 같은
메시지를 흔히 목격할 것입니다: 메시지를 흔히 목격할 것입니다:
@ -84,3 +84,5 @@ git submodule update --init --recursive
[alias] [alias]
su = submodule update --init --recursive su = submodule update --init --recursive
``` ```
[vendor]: https://github.com/electron/electron/tree/master/vendor

View file

@ -0,0 +1,20 @@
# Electron 버전 관리
노련한 Node 개발자라면, `semver` (유의적 버전)에 대해 확실히 알고 있을 것입니다 -
그리고 제공된 의존성 관리 시스템은 고정된 버전 숫자 대신 견고한 가이드라인을 따릅니다.
Electron은 Node와 Chromium에 큰 의존성을 지니고 있는 만큼, 유의적 버전을 그대로
따르지 않습니다. 따라서 항상 Electron의 특정 버전을 참조해야 합니다.
버전 숫자는 다음과 같은 규칙으로 올라갑니다:
* Major: Electron API의 주요 변경 사항을 반영합니다 - 만약 `0.37.0`에서 `1.0.0`
업그레이드하는 경우, 어플리케이션을 업데이트해야 합니다.
* Minor: 주요 Chrome과 Node 버전의 업그레이드를 반영하거나; Electron의 중요한 변경
사항을 반영합니다 - 만약 `1.0.0`에서 `1.1.0`로 업그레이드하는 경우, 어플리케이션은
여전히 작동하겠지만, 약간의 업데이트가 필요할 수 있습니다.
* Patch: 새로운 기능과 버그 수정을 반영합니다 - 만약 `1.0.0`에서 `1.0.1`
업그레이드하는 경우, 어플리케이션은 잘 작동할 것입니다.
`electron-prebuilt`를 사용하고 있다면, Electron의 변경 사항을 확실하게 인지하고
개발자 스스로 업그레이드를 적용하기 위해 고정된 버전 숫자를 사용하는 것을 권장합니다.
(`^1.1.0` 대신 `1.1.0` 사용)