📝 Update Korean docs as upstream
[ci skip]
This commit is contained in:
parent
ee9e28dfdf
commit
7fd3149031
9 changed files with 39 additions and 31 deletions
|
@ -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)
|
||||||
|
|
|
@ -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'
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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')`같은 예전 방식의 빌트인 모듈을 비활성화합니다.
|
|
||||||
|
|
|
@ -107,7 +107,7 @@ remote.getCurrentWindow().on('close', () => {
|
||||||
창을 새로고침 할 때마다 콜백을 새로 설치합니다. 게다가 이전 콜백이 제거되지 않고
|
창을 새로고침 할 때마다 콜백을 새로 설치합니다. 게다가 이전 콜백이 제거되지 않고
|
||||||
계속해서 쌓이면서 메모리 누수가 발생합니다.
|
계속해서 쌓이면서 메모리 누수가 발생합니다.
|
||||||
|
|
||||||
설상가상으로 이전에 등록된 콜백의 콘텍스트가 릴리즈 되고 난 후 (e.g. 페이지 새로고침)
|
설상가상으로 이전에 등록된 콜백의 컨텍스트가 릴리즈 되고 난 후 (e.g. 페이지 새로고침)
|
||||||
`close` 이벤트가 발생하면 예외가 발생하고 메인 프로세스가 작동 중지됩니다.
|
`close` 이벤트가 발생하면 예외가 발생하고 메인 프로세스가 작동 중지됩니다.
|
||||||
|
|
||||||
이러한 문제를 피하려면 렌더러 프로세스에서 메인 프로세스로 넘긴 함수의 참조를 사용 후
|
이러한 문제를 피하려면 렌더러 프로세스에서 메인 프로세스로 넘긴 함수의 참조를 사용 후
|
||||||
|
|
|
@ -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
|
|
||||||
|
|
|
@ -11,6 +11,8 @@
|
||||||
상호작용이 비동기로 작동한다는 것을 의미합니다. 따라서 임베디드 콘텐츠로부터
|
상호작용이 비동기로 작동한다는 것을 의미합니다. 따라서 임베디드 콘텐츠로부터
|
||||||
어플리케이션을 안전하게 유지할 수 있습니다.
|
어플리케이션을 안전하게 유지할 수 있습니다.
|
||||||
|
|
||||||
|
보안상의 이유로, `webview`는 `nodeIntegration`이 활성화된 `BrowserWindow`에서만 사용할 수 있습니다.
|
||||||
|
|
||||||
## 예시
|
## 예시
|
||||||
|
|
||||||
웹 페이지를 어플리케이션에 삽입하려면 `webview` 태그를 사용해 원하는 타겟 페이지에
|
웹 페이지를 어플리케이션에 삽입하려면 `webview` 태그를 사용해 원하는 타겟 페이지에
|
||||||
|
|
|
@ -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
|
||||||
|
|
20
docs-translations/ko-KR/tutorial/electron-versioning.md
Normal file
20
docs-translations/ko-KR/tutorial/electron-versioning.md
Normal 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` 사용)
|
Loading…
Reference in a new issue