📝 Update Korean docs as upstream

[ci skip]
This commit is contained in:
Plusb Preco 2016-06-13 12:19:37 +09:00
parent 68e99be9f6
commit 951aa72847
6 changed files with 100 additions and 53 deletions

View file

@ -95,11 +95,12 @@ Returns:
`autoUpdater` 객체에서 사용할 수 있는 메서드입니다: `autoUpdater` 객체에서 사용할 수 있는 메서드입니다:
### `autoUpdater.setFeedURL(url)` ### `autoUpdater.setFeedURL(url[, requestHeaders])`
* `url` String * `url` String
* `requestHeaders` Object _OS X_ - HTTP 요청 헤더.
`url`을 설정하고 자동 업데이터를 초기화합니다. `url`은 한번 설정되면 변경할 수 없습니다. `url`을 설정하고 자동 업데이터를 초기화합니다.
### `autoUpdater.checkForUpdates()` ### `autoUpdater.checkForUpdates()`

View file

@ -176,9 +176,12 @@ On Windows it is
사용하는지를 지정합니다. 기본값은 `true`입니다. 사용하는지를 지정합니다. 기본값은 `true`입니다.
* `scrollBounce` Boolean - OS X에서 스크롤 튕기기 효과 (탄성 밴딩)를 활성화 합니다. * `scrollBounce` Boolean - OS X에서 스크롤 튕기기 효과 (탄성 밴딩)를 활성화 합니다.
기본값은 `false`입니다. 기본값은 `false`입니다.
* `blinkFeatures` String - `CSSVariables,KeyboardEventKey`같은 `,`로 구분된 * `blinkFeatures` String - 활성화 할 `CSSVariables,KeyboardEventKey`같이 `,`
기능 문자열들의 리스트입니다. 지원하는 전체 기능 문자열들은 구분된 기능 문자열들의 리스트입니다. [RuntimeEnabledFeatures.in][blink-feature-string]
[setFeatureEnabledFromString][blink-feature-string] 함수에서 찾을 수 있습니다. 파일에서 찾을 수 있습니다.
* `disableBlinkFeatures` String - 비활성화 할 `CSSVariables,KeyboardEventKey`같이
`,`로 구분된 기능 문자열들의 리스트입니다. [RuntimeEnabledFeatures.in][blink-feature-string]
파일에서 찾을 수 있습니다.
* `defaultFontFamily` Object - font-family의 기본 폰트를 지정합니다. * `defaultFontFamily` Object - font-family의 기본 폰트를 지정합니다.
* `standard` String - 기본값 `Times New Roman`. * `standard` String - 기본값 `Times New Roman`.
* `serif` String - 기본값 `Times New Roman`. * `serif` String - 기본값 `Times New Roman`.
@ -392,6 +395,17 @@ ID에 해당하는 윈도우를 찾습니다.
`name`에 해당하는 개발자 도구 확장 기능을 제거합니다. `name`에 해당하는 개발자 도구 확장 기능을 제거합니다.
### `BrowserWindow.getDevToolsExtensions()`
키는 확장 기능 이름을 값은 `name``version` 속성을 포함하는 객체를 가지는 객체를
반환합니다.
개발자 도구 확장 기능이 설치되었는지 확인하려면 다음과 같이 실행할 수 있습니다:
```javascript
let installed = BrowserWindow.getDevToolsExtensions().hasOwnProperty('devtron')
```
## Instance Properties ## Instance Properties
`new BrowserWindow`로 생성한 객체는 다음과 같은 속성을 가지고 있습니다: `new BrowserWindow`로 생성한 객체는 다음과 같은 속성을 가지고 있습니다:
@ -926,4 +940,4 @@ Linux 플랫폼에선 Unity 데스크톱 환경만 지원합니다. 그리고
이 윈도우에서 일어나는 모든 마우스 이벤트가 이 윈도우 밑의 윈도우로 전달됩니다. 하지만 이 윈도우에서 일어나는 모든 마우스 이벤트가 이 윈도우 밑의 윈도우로 전달됩니다. 하지만
이 윈도우가 포커스되어 있다면, 여전히 키보드 이벤트는 받을 수 있습니다. 이 윈도우가 포커스되어 있다면, 여전히 키보드 이벤트는 받을 수 있습니다.
[blink-feature-string]: https://code.google.com/p/chromium/codesearch#chromium/src/out/Debug/gen/blink/platform/RuntimeEnabledFeatures.cpp&sq=package:chromium&type=cs&l=576 [blink-feature-string]: https://cs.chromium.org/chromium/src/third_party/WebKit/Source/platform/RuntimeEnabledFeatures.in

View file

@ -205,6 +205,8 @@ Menu.setApplicationMenu(menu);
지정한 `menu`를 애플리케이션 메뉴로 만듭니다. OS X에선 상단바에 표시되며 Windows와 지정한 `menu`를 애플리케이션 메뉴로 만듭니다. OS X에선 상단바에 표시되며 Windows와
Linux에선 각 창의 상단에 표시됩니다. Linux에선 각 창의 상단에 표시됩니다.
**참고** 이 API는 `app``ready` 이벤트가 발생한 이후에 호출해야 합니다.
### `Menu.sendActionToFirstResponder(action)` _OS X_ ### `Menu.sendActionToFirstResponder(action)` _OS X_
* `action` String * `action` String

View file

@ -196,9 +196,19 @@ API를 사용할 수 있습니다. 이를 지정하면 내부에서 로우레벨
<webview src="https://www.github.com/" blinkfeatures="PreciseMemoryInfo, CSSVariables"></webview> <webview src="https://www.github.com/" blinkfeatures="PreciseMemoryInfo, CSSVariables"></webview>
``` ```
활성화할 blink 기능을 지정한 `,`로 구분된 문자열의 리스트입니다. 지원하는 기능 문자열의 활성화할 blink 기능을 지정한 `,`로 구분된 문자열의 리스트입니다. 지원하는 기능
전체 목록은 [setFeatureEnabledFromString][blink-feature-string] 함수에서 찾을 수 문자열의 전체 목록은 [RuntimeEnabledFeatures.in][blink-feature-string] 파일에서
있습니다. 찾을 수 있습니다.
### `disableblinkfeatures`
```html
<webview src="https://www.github.com/" disableblinkfeatures="PreciseMemoryInfo, CSSVariables"></webview>
```
비활성화할 blink 기능을 지정한 `,`로 구분된 문자열의 리스트입니다. 지원하는 기능
문자열의 전체 목록은 [RuntimeEnabledFeatures.in][blink-feature-string] 파일에서
찾을 수 있습니다.
## Methods ## Methods
@ -793,4 +803,4 @@ Returns:
개발자 도구가 포커스되거나 열렸을 때 발생하는 이벤트입니다. 개발자 도구가 포커스되거나 열렸을 때 발생하는 이벤트입니다.
[blink-feature-string]: https://code.google.com/p/chromium/codesearch#chromium/src/out/Debug/gen/blink/platform/RuntimeEnabledFeatures.cpp&sq=package:chromium&type=cs&l=527 [blink-feature-string]: https://cs.chromium.org/chromium/src/third_party/WebKit/Source/platform/RuntimeEnabledFeatures.in

View file

@ -120,20 +120,23 @@ productbuild --component "$APP_PATH" /Applications --sign "$INSTALLER_KEY" "$RES
문서를 참고하여 기본적인 개념을 이해해야 합니다. 그리고 자격(plist) 파일에 문서를 참고하여 기본적인 개념을 이해해야 합니다. 그리고 자격(plist) 파일에
애플리케이션에서 요구하는 권한의 키를 추가합니다. 애플리케이션에서 요구하는 권한의 키를 추가합니다.
그 외에 [electron-osx-sign][electron-osx-sign] 모듈을 이용해서 직접 서명할 수도 있습니다.
#### 네이티브 모듈 서명하기 그 외에 별로도 [electron-osx-sign][electron-osx-sign] 모듈을 사용하여 직접 서명할
수도 있습니다.
앱 내부에서 사용한 네이티브 모듈들도 서명이 필요합니다. #### 네이티브 모듈에 서명하기
electron-osx-sign 을 사용한다면, 앱 실행 인수 목록에 경로를 반드시 지정해야 합니다.
앱 내부에서 사용한 네이티브 모듈도 서명이 필요합니다. `electron-osx-sign`
사용한다면, 인수 목록에 빌트인 바이너리 경로가 포함되어 있는지 확인해야 합니다:
```bash ```bash
electron-osx-sign YourApp.app YourApp.app/Contents/Resources/app/node_modules/nativemodule/build/release/nativemodule electron-osx-sign YourApp.app YourApp.app/Contents/Resources/app/node_modules/nativemodule/build/release/nativemodule
``` ```
참고할 점은 네이티브 모듈이 의도하지 않았지만 오브젝트 파일(.o)을 포함하는 경우도 있습니다. 참고로 네이티브 모듈이 의도하지 않게 중간 파일을 포함하는 경우도 있으며 이 파일은
이 경우 오브젝트 파일들의 서명을 해야할 수도 있습니다. 포함되어선 안됩니다. (해당 파일에도 서명해야 할 수도 있습니다)
[electron-packager][electron-packager]를 사용한다면, 빌드 과정에 `--ignore=.+\.o$` 코드를 추가해 해당 파일을 무시해줍시다. [electron-packager][electron-packager]를 사용한다면, 빌드 과정에 `--ignore=.+\.o$`
인수를 추가하여 중간 파일을 무시할 수 있습니다.
### 애플리케이션 업로드 ### 애플리케이션 업로드

View file

@ -5,7 +5,7 @@ Windows Platform. 새로운 `.appx` 포맷은 Cortana와 푸시 알림과 같은
API뿐만 아니라, Windows Store를 통해 설치와 업데이트를 단순화합니다. API뿐만 아니라, Windows Store를 통해 설치와 업데이트를 단순화합니다.
Microsoft는 개발자들이 새로운 애플리케이션 모델의 좋은 기능들을 사용할 수 있도록 Microsoft는 개발자들이 새로운 애플리케이션 모델의 좋은 기능들을 사용할 수 있도록
[Electron 애플리케이션을 `.appx` 패키지로 컴파일시키는 도구를 개발했습니다](http://github.com/catalystcode/electron-windows-store). [Electron 애플리케이션을 `.appx` 패키지로 컴파일시키는 도구를 개발했습니다][electron-windows-store].
이 가이드는 이 도구를 사용하는 방법과 Electron AppX 패키지의 호환성과 한정 사항을 이 가이드는 이 도구를 사용하는 방법과 Electron AppX 패키지의 호환성과 한정 사항을
설명합니다. 설명합니다.
@ -16,25 +16,21 @@ Windows 10 "기념일 업데이트"는 win32 `.exe` 바이너리를 가상화된
애플리케이션과 Windows 컨테이너 안의 인스톨러에 의해 컴파일되는 동안 만들어지며, 애플리케이션과 Windows 컨테이너 안의 인스톨러에 의해 컴파일되는 동안 만들어지며,
설치가 되는 동안 Windows가 확실하게 어떤 변경 사항이 운영 체제에 적용되는지 식별할 수 설치가 되는 동안 Windows가 확실하게 어떤 변경 사항이 운영 체제에 적용되는지 식별할 수
있도록 합니다. 가상 파일 시스템과 가상 레지스트리를 페어링 하는 실행 파일은 Windows가 있도록 합니다. 가상 파일 시스템과 가상 레지스트리를 페어링 하는 실행 파일은 Windows가
원-클릭으로 설치와 삭제를 할 수 있도록 만듭니다. 한 번의 클릭으로 설치와 삭제를 할 수 있도록 만듭니다.
더 나아가서, exe는 appx 모델 안에서 실행됩니다 - 이 말은 즉 Universial Windows 더 나아가서, exe는 appx 모델 안에서 실행됩니다 - 이 말은 즉 Universial Windows
Platform에서 제공되는 수많은 API를 사용할 수 있다는 이야기입니다. 더 많은 기능을 Platform에서 제공되는 수많은 API를 사용할 수 있다는 이야기입니다. 더 많은 기능을
사용하기 위해, Electron 애플리케이션은 숨겨진 UWP 앱과 페어링 하여 `exe`와 같이 사용하기 위해, Electron 애플리케이션은 백그라운드로 실행된 UWP 앱과 페어링 하여
실행할 수 있습니다 - 이렇게 헬퍼와 비슷하게 실행되고 작업을 실행하기 위해 `exe`와 같이 실행할 수 있습니다 - 이렇게 헬퍼와 비슷하게 실행되고 작업을 실행하기 위해
백그라운드에서 작동하며, 푸시 알림을 받거나, 다른 UWP 애플리케이션과 통신하는 역할을 백그라운드에서 작동하며, 푸시 알림을 받거나, 다른 UWP 애플리케이션과 통신하는 역할을
합니다. 합니다.
현재 존재하는 Electron 애플리케이션을 컴파일 하려면, 다음 요구 사항을 충족해야 합니다: 현재 존재하는 Electron 애플리케이션을 컴파일 하려면, 다음 요구 사항을 충족해야 합니다:
* Windows 10 기념일 업데이트 - 엔터프라이즈 에디션 (이 업데이트는 빌드 번호가 14316
이거나, 더 높습니다 - 2016년 5월, Windows Insiders Preview 업데이트에 포함되어 * Windows 10 기념일 업데이트 (이 업데이트가 정식 배포되기 전까지 개발자는 Windows
있습니다) Insider Preview를 사용할 수 있습니다)
* 64 비트 (x64) 머신과 프로세서, 하드웨어-보조 가상화, 그리고 Second Level Address * Windows 10 SDK, [여기서 다운로드][windows-sdk]
Translation (SLAT)
* Windows 10 SDK, [여기서](https://developer.microsoft.com/en-us/windows/downloads/windows-10-sdk)
다운로드할 수 있습니다.
* 최소 Node 4 버전 이상 (버전을 확인하려면 `node -v`를 실행하세요)
그리고 CLI에서 `electron-windows-store`를 설치합니다: 그리고 CLI에서 `electron-windows-store`를 설치합니다:
@ -42,25 +38,7 @@ Platform에서 제공되는 수많은 API를 사용할 수 있다는 이야기
npm install -g electron-windows-store npm install -g electron-windows-store
``` ```
## 설정과 준비 ## Step 1: Electron 어플리케이션 패키징
처음 CLI를 실행하기 전에, "Windows Desktop App Converter"를 먼저 설정해야 합니다.
이 작업은 약 몇 분 정도 소요됩니다. 하지만 걱정하지 않아도 됩니다 - 이 작업은 딱 한
번만 하면 됩니다. Desktop App Converter는 [여기](https://www.microsoft.com/en-us/download/details.aspx?id=51691)에서
다운로드받을 수 있고, `DesktopAppConverter.zip``BaseImage-14316.wim` 두 파일을
모두 받아야 합니다.
1. `DesktopAppConverter.zip`의 압축을 풉니다. 그다음 PowerShell을 관리자 권한으로
실행하고 압축을 푼 위치로 이동합니다. (실행하는 모든 명령에 "관리자 권한"을
적용하려면 `Set-ExecutionPolicy bypass`를 실행하면 됩니다)
2. 그리고, `.\DesktopAppConverter.ps1 -Setup -BaseImage .\BaseImage-14316.wim`
실행하여 Windows 베이스 이미지 (`BaseImage-14316.wim`)를 Desktop App Converter로
전달하고 설치를 진행합니다.
3. 만약 위 명령이 재시작을 요구하면, 기기를 재시작하고 위 명령을 다시 실행시키세요.
설치가 완료되면, 컴파일할 Electron 애플리케이션 경로로 이동합니다.
## Electron 애플리케이션 패키지 만들기
[electron-packager](https://github.com/electron-userland/electron-packager)를 [electron-packager](https://github.com/electron-userland/electron-packager)를
사용하여 애플리케이션을 패키징합니다. (또는 비슷한 도구를 사용합니다) 마지막으로 최종 사용하여 애플리케이션을 패키징합니다. (또는 비슷한 도구를 사용합니다) 마지막으로 최종
@ -98,7 +76,7 @@ npm install -g electron-windows-store
└── xinput1_3.dll └── xinput1_3.dll
``` ```
## 명령줄 도구 실행하기 ## `electron-windows-store` 실행하기
관리자 권한의 PowerShell ("관리자 권한으로 실행")을 실행하고, 디렉토리 입력과 출력, 관리자 권한의 PowerShell ("관리자 권한으로 실행")을 실행하고, 디렉토리 입력과 출력,
애플리케이션의 이름과 버전, 마지막으로 `node_modules`를 평탄화시키는 인수들과 함께 애플리케이션의 이름과 버전, 마지막으로 `node_modules`를 평탄화시키는 인수들과 함께
@ -124,13 +102,52 @@ Windows Application Manifest (`AppXManifest.xml`)와 동시에 가상 파일 시
도구는 새 AppX 패키지에 서명하기 위해 컴퓨터에서 신뢰된 인증서를 만드는 데 사용할 수 도구는 새 AppX 패키지에 서명하기 위해 컴퓨터에서 신뢰된 인증서를 만드는 데 사용할 수
있습니다. 서명된 AppX 패키지로, CLI는 자동으로 기기에 패키지를 설치할 수 있습니다. 있습니다. 서명된 AppX 패키지로, CLI는 자동으로 기기에 패키지를 설치할 수 있습니다.
## AppX 패키지 사용하기 ## Step 3: AppX 패키지 사용하기
Windows 기념일 업데이트 (코드네임 Windows 레드스톤)가 아직 모든 일반 사용자에게 Windows 기념일 업데이트 (코드네임 Windows 레드스톤)가 아직 모든 일반 사용자에게
배포되지 않았기 때문에, 올해까지는 애플리케이션을 Windows Store에 올릴 수 없을 것 배포되지 않았기 때문에, 올해까지는 애플리케이션을 Windows Store에 올릴 수 없을 것
입니다 - 하지만 개발자 또는 회사 환경에서 `Add-AppxPackage` 입니다 - 하지만 개발자 또는 회사 환경에서 `Add-AppxPackage`
[PowerShell Cmdlet을 통해](https://technet.microsoft.com/en-us/library/hh856048.aspx) [PowerShell Cmdlet을 통해][add-appxpackage] 기기에 애플리케이션을 설치할 수 있습니다.
기기에 애플리케이션을 설치할 수 있습니다.
또 다른 중요한 제약은 컴파일된 AppX 패키지는 여전히 win32 실행 파일이 담겨있다는 또 다른 중요한 제약은 컴파일된 AppX 패키지는 여전히 win32 실행 파일이 담겨있다는
것입니다 - 따라서 Xbox, HoloLen, Phone에서 실행할 수 없습니다. 것입니다 - 따라서 Xbox, HoloLens, Phone에서 실행할 수 없습니다.
## Optional: 백그라운드 작업을 사용하여 UWP 기능 추가
필요하다면 Windows 10의 모든 기능을 사용하기 위해 보이지 않는 UWP 백그라운드 작업과
Electron 앱을 연결할 수 있습니다 - 푸시 알림, 코타나 통합, 라이브 타일등.
Electron 앱이 토스트 알림이나 라이브 타일을 사용할 수 있도록 하는 방법을 알아보려면
[Microsoft가 제공하는 샘플을 참고하세요][background-task].
## Optional: 컨테이너 가상화를 사용하여 변환
AppX 패키지를 만드려면, `electron-windows-store` CLI를 통해 대부분의 Electron 앱을
그대로 변환할 수 있습니다. 하지만, 커스텀 인스톨러를 사용하고 있거나, 패키지를
생성하는데 어떠한 문제라도 겪고있다면, Windows Container를 사용하여 패키지를 생성하는
시도를 해볼 수 있습니다 - 이 모드를 사용하면, CLI가 어플리케이션이 정확하게 운영체제에
대해 수행하는 작업이 어떤 변경 사항을 만드는지를 결정하기 위해 어플리케이션을 빈 Windows
Container에서 설치하고 실행할 것입니다.
처음 CLI를 실행하기 전에, "Windows Desktop App Converter"를 먼저 설정해야 합니다.
이 작업은 약 몇 분 정도 소요됩니다. 하지만 걱정하지 않아도 됩니다 - 이 작업은 딱 한
번만 하면 됩니다. Desktop App Converter는 [여기][app-converter]에서 다운로드 받을
수 있고, `DesktopAppConverter.zip``BaseImage-14316.wim` 두 파일을 모두 받아야
합니다.
1. `DesktopAppConverter.zip`의 압축을 풉니다. 그다음 PowerShell을 관리자 권한으로
실행하고 압축을 푼 위치로 이동합니다. (실행하는 모든 명령에 "관리자 권한"을
적용하려면 `Set-ExecutionPolicy bypass`를 실행하면 됩니다)
2. 그리고, `.\DesktopAppConverter.ps1 -Setup -BaseImage .\BaseImage-14316.wim`
실행하여 Windows 베이스 이미지 (`BaseImage-14316.wim`)를 Desktop App Converter로
전달하고 설치를 진행합니다.
3. 만약 위 명령이 재시작을 요구하면, 기기를 재시작하고 위 명령을 다시 실행시키세요.
설치가 완료되면, 컴파일할 Electron 애플리케이션 경로로 이동합니다.
[windows-sdk]: https://developer.microsoft.com/en-us/windows/downloads/windows-10-sdk
[app-converter]: https://www.microsoft.com/en-us/download/details.aspx?id=51691
[add-appxpackage]: https://technet.microsoft.com/en-us/library/hh856048.aspx
[electron-packager]: https://github.com/electron-userland/electron-packager
[electron-windows-store]: https://github.com/catalystcode/electron-windows-store
[background-task]: https://github.com/felixrieseberg/electron-uwp-background