📝 Update Korean docs as upstream
[ci skip]
This commit is contained in:
Plusb Preco
parent
68e99be9f6
commit
951aa72847
6 changed files with 100 additions and 53 deletions
|
|
@ -95,11 +95,12 @@ Returns:
|
|||
|
||||
`autoUpdater` 객체에서 사용할 수 있는 메서드입니다:
|
||||
|
||||
### `autoUpdater.setFeedURL(url)`
|
||||
### `autoUpdater.setFeedURL(url[, requestHeaders])`
|
||||
|
||||
* `url` String
|
||||
* `requestHeaders` Object _OS X_ - HTTP 요청 헤더.
|
||||
|
||||
`url`을 설정하고 자동 업데이터를 초기화합니다. `url`은 한번 설정되면 변경할 수 없습니다.
|
||||
`url`을 설정하고 자동 업데이터를 초기화합니다.
|
||||
|
||||
### `autoUpdater.checkForUpdates()`
|
||||
|
||||
|
|
|
|||
|
|
@ -176,9 +176,12 @@ On Windows it is
|
|||
사용하는지를 지정합니다. 기본값은 `true`입니다.
|
||||
* `scrollBounce` Boolean - OS X에서 스크롤 튕기기 효과 (탄성 밴딩)를 활성화 합니다.
|
||||
기본값은 `false`입니다.
|
||||
* `blinkFeatures` String - `CSSVariables,KeyboardEventKey`같은 `,`로 구분된
|
||||
기능 문자열들의 리스트입니다. 지원하는 전체 기능 문자열들은
|
||||
[setFeatureEnabledFromString][blink-feature-string] 함수에서 찾을 수 있습니다.
|
||||
* `blinkFeatures` String - 활성화 할 `CSSVariables,KeyboardEventKey`같이 `,`로
|
||||
구분된 기능 문자열들의 리스트입니다. [RuntimeEnabledFeatures.in][blink-feature-string]
|
||||
파일에서 찾을 수 있습니다.
|
||||
* `disableBlinkFeatures` String - 비활성화 할 `CSSVariables,KeyboardEventKey`같이
|
||||
`,`로 구분된 기능 문자열들의 리스트입니다. [RuntimeEnabledFeatures.in][blink-feature-string]
|
||||
파일에서 찾을 수 있습니다.
|
||||
* `defaultFontFamily` Object - font-family의 기본 폰트를 지정합니다.
|
||||
* `standard` String - 기본값 `Times New Roman`.
|
||||
* `serif` String - 기본값 `Times New Roman`.
|
||||
|
|
@ -392,6 +395,17 @@ ID에 해당하는 윈도우를 찾습니다.
|
|||
|
||||
`name`에 해당하는 개발자 도구 확장 기능을 제거합니다.
|
||||
|
||||
### `BrowserWindow.getDevToolsExtensions()`
|
||||
|
||||
키는 확장 기능 이름을 값은 `name`과 `version` 속성을 포함하는 객체를 가지는 객체를
|
||||
반환합니다.
|
||||
|
||||
개발자 도구 확장 기능이 설치되었는지 확인하려면 다음과 같이 실행할 수 있습니다:
|
||||
|
||||
```javascript
|
||||
let installed = BrowserWindow.getDevToolsExtensions().hasOwnProperty('devtron')
|
||||
```
|
||||
|
||||
## Instance Properties
|
||||
|
||||
`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
|
||||
|
|
|
|||
|
|
@ -205,6 +205,8 @@ Menu.setApplicationMenu(menu);
|
|||
지정한 `menu`를 애플리케이션 메뉴로 만듭니다. OS X에선 상단바에 표시되며 Windows와
|
||||
Linux에선 각 창의 상단에 표시됩니다.
|
||||
|
||||
**참고** 이 API는 `app`의 `ready` 이벤트가 발생한 이후에 호출해야 합니다.
|
||||
|
||||
### `Menu.sendActionToFirstResponder(action)` _OS X_
|
||||
|
||||
* `action` String
|
||||
|
|
|
|||
|
|
@ -196,9 +196,19 @@ API를 사용할 수 있습니다. 이를 지정하면 내부에서 로우레벨
|
|||
<webview src="https://www.github.com/" blinkfeatures="PreciseMemoryInfo, CSSVariables"></webview>
|
||||
```
|
||||
|
||||
활성화할 blink 기능을 지정한 `,`로 구분된 문자열의 리스트입니다. 지원하는 기능 문자열의
|
||||
전체 목록은 [setFeatureEnabledFromString][blink-feature-string] 함수에서 찾을 수
|
||||
있습니다.
|
||||
활성화할 blink 기능을 지정한 `,`로 구분된 문자열의 리스트입니다. 지원하는 기능
|
||||
문자열의 전체 목록은 [RuntimeEnabledFeatures.in][blink-feature-string] 파일에서
|
||||
찾을 수 있습니다.
|
||||
|
||||
### `disableblinkfeatures`
|
||||
|
||||
```html
|
||||
<webview src="https://www.github.com/" disableblinkfeatures="PreciseMemoryInfo, CSSVariables"></webview>
|
||||
```
|
||||
|
||||
비활성화할 blink 기능을 지정한 `,`로 구분된 문자열의 리스트입니다. 지원하는 기능
|
||||
문자열의 전체 목록은 [RuntimeEnabledFeatures.in][blink-feature-string] 파일에서
|
||||
찾을 수 있습니다.
|
||||
|
||||
## 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
|
||||
|
|
|
|||
|
|
@ -120,20 +120,23 @@ productbuild --component "$APP_PATH" /Applications --sign "$INSTALLER_KEY" "$RES
|
|||
문서를 참고하여 기본적인 개념을 이해해야 합니다. 그리고 자격(plist) 파일에
|
||||
애플리케이션에서 요구하는 권한의 키를 추가합니다.
|
||||
|
||||
그 외에 [electron-osx-sign][electron-osx-sign] 모듈을 이용해서 직접 서명할 수도 있습니다.
|
||||
|
||||
#### 네이티브 모듈 서명하기
|
||||
그 외에 별로도 [electron-osx-sign][electron-osx-sign] 모듈을 사용하여 직접 서명할
|
||||
수도 있습니다.
|
||||
|
||||
앱 내부에서 사용한 네이티브 모듈들도 서명이 필요합니다.
|
||||
electron-osx-sign 을 사용한다면, 앱 실행 인수 목록에 경로를 반드시 지정해야 합니다.
|
||||
#### 네이티브 모듈에 서명하기
|
||||
|
||||
앱 내부에서 사용한 네이티브 모듈도 서명이 필요합니다. `electron-osx-sign`을
|
||||
사용한다면, 인수 목록에 빌트인 바이너리 경로가 포함되어 있는지 확인해야 합니다:
|
||||
|
||||
```bash
|
||||
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$`
|
||||
인수를 추가하여 중간 파일을 무시할 수 있습니다.
|
||||
|
||||
### 애플리케이션 업로드
|
||||
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@ Windows Platform. 새로운 `.appx` 포맷은 Cortana와 푸시 알림과 같은
|
|||
API뿐만 아니라, Windows Store를 통해 설치와 업데이트를 단순화합니다.
|
||||
|
||||
Microsoft는 개발자들이 새로운 애플리케이션 모델의 좋은 기능들을 사용할 수 있도록
|
||||
[Electron 애플리케이션을 `.appx` 패키지로 컴파일시키는 도구를 개발했습니다](http://github.com/catalystcode/electron-windows-store).
|
||||
[Electron 애플리케이션을 `.appx` 패키지로 컴파일시키는 도구를 개발했습니다][electron-windows-store].
|
||||
이 가이드는 이 도구를 사용하는 방법과 Electron AppX 패키지의 호환성과 한정 사항을
|
||||
설명합니다.
|
||||
|
||||
|
|
@ -16,25 +16,21 @@ Windows 10 "기념일 업데이트"는 win32 `.exe` 바이너리를 가상화된
|
|||
애플리케이션과 Windows 컨테이너 안의 인스톨러에 의해 컴파일되는 동안 만들어지며,
|
||||
설치가 되는 동안 Windows가 확실하게 어떤 변경 사항이 운영 체제에 적용되는지 식별할 수
|
||||
있도록 합니다. 가상 파일 시스템과 가상 레지스트리를 페어링 하는 실행 파일은 Windows가
|
||||
원-클릭으로 설치와 삭제를 할 수 있도록 만듭니다.
|
||||
한 번의 클릭으로 설치와 삭제를 할 수 있도록 만듭니다.
|
||||
|
||||
더 나아가서, exe는 appx 모델 안에서 실행됩니다 - 이 말은 즉 Universial Windows
|
||||
Platform에서 제공되는 수많은 API를 사용할 수 있다는 이야기입니다. 더 많은 기능을
|
||||
사용하기 위해, Electron 애플리케이션은 숨겨진 UWP 앱과 페어링 하여 `exe`와 같이
|
||||
실행할 수 있습니다 - 이렇게 헬퍼와 비슷하게 실행되고 작업을 실행하기 위해
|
||||
사용하기 위해, Electron 애플리케이션은 백그라운드로 실행된 UWP 앱과 페어링 하여
|
||||
`exe`와 같이 실행할 수 있습니다 - 이렇게 헬퍼와 비슷하게 실행되고 작업을 실행하기 위해
|
||||
백그라운드에서 작동하며, 푸시 알림을 받거나, 다른 UWP 애플리케이션과 통신하는 역할을
|
||||
합니다.
|
||||
|
||||
현재 존재하는 Electron 애플리케이션을 컴파일 하려면, 다음 요구 사항을 충족해야 합니다:
|
||||
|
||||
* Windows 10 기념일 업데이트 - 엔터프라이즈 에디션 (이 업데이트는 빌드 번호가 14316
|
||||
이거나, 더 높습니다 - 2016년 5월, Windows Insiders Preview 업데이트에 포함되어
|
||||
있습니다)
|
||||
* 64 비트 (x64) 머신과 프로세서, 하드웨어-보조 가상화, 그리고 Second Level Address
|
||||
Translation (SLAT)
|
||||
* Windows 10 SDK, [여기서](https://developer.microsoft.com/en-us/windows/downloads/windows-10-sdk)
|
||||
다운로드할 수 있습니다.
|
||||
* 최소 Node 4 버전 이상 (버전을 확인하려면 `node -v`를 실행하세요)
|
||||
|
||||
* Windows 10 기념일 업데이트 (이 업데이트가 정식 배포되기 전까지 개발자는 Windows
|
||||
Insider Preview를 사용할 수 있습니다)
|
||||
* Windows 10 SDK, [여기서 다운로드][windows-sdk]
|
||||
|
||||
그리고 CLI에서 `electron-windows-store`를 설치합니다:
|
||||
|
||||
|
|
@ -42,25 +38,7 @@ Platform에서 제공되는 수많은 API를 사용할 수 있다는 이야기
|
|||
npm install -g electron-windows-store
|
||||
```
|
||||
|
||||
## 설정과 준비
|
||||
|
||||
처음 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 애플리케이션 패키지 만들기
|
||||
## Step 1: Electron 어플리케이션 패키징
|
||||
|
||||
[electron-packager](https://github.com/electron-userland/electron-packager)를
|
||||
사용하여 애플리케이션을 패키징합니다. (또는 비슷한 도구를 사용합니다) 마지막으로 최종
|
||||
|
|
@ -98,7 +76,7 @@ npm install -g electron-windows-store
|
|||
└── xinput1_3.dll
|
||||
```
|
||||
|
||||
## 명령줄 도구 실행하기
|
||||
## `electron-windows-store` 실행하기
|
||||
|
||||
관리자 권한의 PowerShell ("관리자 권한으로 실행")을 실행하고, 디렉토리 입력과 출력,
|
||||
애플리케이션의 이름과 버전, 마지막으로 `node_modules`를 평탄화시키는 인수들과 함께
|
||||
|
|
@ -124,13 +102,52 @@ Windows Application Manifest (`AppXManifest.xml`)와 동시에 가상 파일 시
|
|||
도구는 새 AppX 패키지에 서명하기 위해 컴퓨터에서 신뢰된 인증서를 만드는 데 사용할 수
|
||||
있습니다. 서명된 AppX 패키지로, CLI는 자동으로 기기에 패키지를 설치할 수 있습니다.
|
||||
|
||||
## AppX 패키지 사용하기
|
||||
## Step 3: AppX 패키지 사용하기
|
||||
|
||||
Windows 기념일 업데이트 (코드네임 Windows 레드스톤)가 아직 모든 일반 사용자에게
|
||||
배포되지 않았기 때문에, 올해까지는 애플리케이션을 Windows Store에 올릴 수 없을 것
|
||||
입니다 - 하지만 개발자 또는 회사 환경에서 `Add-AppxPackage`
|
||||
[PowerShell Cmdlet을 통해](https://technet.microsoft.com/en-us/library/hh856048.aspx)
|
||||
기기에 애플리케이션을 설치할 수 있습니다.
|
||||
[PowerShell Cmdlet을 통해][add-appxpackage] 기기에 애플리케이션을 설치할 수 있습니다.
|
||||
|
||||
또 다른 중요한 제약은 컴파일된 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
|
||||
|
|
|
|||
Loading…
Reference in a new issue