167 lines
7.4 KiB
Markdown
167 lines
7.4 KiB
Markdown
# remote
|
|
|
|
> 메인 프로세스 모듈을 렌더러 프로세스에서 사용합니다.
|
|
|
|
`remote` 모듈은 메인 프로세스와 렌더러 프로세스(웹 페이지) 사이의 inter-process
|
|
(IPC) 통신을 간단하게 추상화 한 모듈입니다.
|
|
|
|
Electron의 메인 프로세스에선 GUI와 관련 있는(`dialog`, `menu`등) 모듈만 사용할
|
|
수 있습니다. 렌더러 프로세스에서 이러한 모듈들을 사용하려면 `ipc` 모듈을 통해
|
|
메인 프로세스와 inter-process 통신을 해야 합니다. 또한, `remote` 모듈을 사용하면
|
|
inter-process 통신을 하지 않고도 간단한 API를 통해 직접 메인 프로세스의 모듈과
|
|
메서드를 사용할 수 있습니다. 이 개념은 Java의 [RMI][rmi]와 비슷합니다.
|
|
|
|
다음 예시는 렌더러 프로세스에서 브라우저 창을 만드는 예시입니다:
|
|
|
|
```javascript
|
|
const {BrowserWindow} = require('electron').remote
|
|
|
|
let win = new BrowserWindow({width: 800, height: 600})
|
|
win.loadURL('https://github.com')
|
|
```
|
|
|
|
**참고:** 반대로 메인 프로세스에서 렌더러 프로세스에 접근 하려면
|
|
[webContents.executeJavascript](web-contents.md#contentsexecutejavascriptcode-usergesture-callback)
|
|
메서드를 사용하면 됩니다.
|
|
|
|
## Remote 객체
|
|
|
|
`remote` 모듈로부터 반환된 각 객체(메서드 포함)는 메인 프로세스의 객체를 추상화
|
|
한 객체입니다. (우리는 그것을 remote 객체 또는 remote 함수라고 부릅니다) Remote
|
|
모듈의 메서드를 호출하거나, 객체에 접근하거나, 생성자로 객체를 생성하는 등의
|
|
작업은 실질적으로 동기형 inter-process 메시지를 보냅니다.
|
|
|
|
위의 예시에서 사용한 두 `BrowserWindow`와 `win`은 remote 객체입니다. 그리고
|
|
`new BrowserWindow`이 생성하는 `BrowserWindow` 객체는 렌더러 프로세스에서
|
|
생성되지 않습니다. 대신에 이 `BrowserWindow` 객체는 메인 프로세스에서 생성되며
|
|
렌더러 프로세스에 `win` 객체와 같이 이에 대응하는 remote 객체를 반환합니다.
|
|
|
|
**참고:** remote 객체가 처음 참조될 때 표시되는
|
|
[enumerable 속성][enumerable-properties]은 remote를 통해서만 접근할 수 있습니다.
|
|
|
|
**참고:** 배열과 버퍼는 `remote` 모듈을 통해 접근할 때 IPC 를 통해
|
|
복사됩니다. 렌더러 프로세스에서의 수정은 메인 프로세스의 것을 수정하지 않으며,
|
|
반대의 경우도 마찬가지 입니다.
|
|
|
|
## Remote 객체의 생명 주기
|
|
|
|
Electron은 렌더러 프로세스의 remote 객체가 살아있는 한(다시 말해서 GC(garbage
|
|
collection)가 일어나지 않습니다) 대응하는 메인 프로세스의 객체는 릴리즈되지
|
|
않습니다. Remote 객체가 GC 되려면 대응하는 메인 프로세스 내부 객체의 참조가
|
|
해제되어야만 합니다.
|
|
|
|
만약 remote 객체가 렌더러 프로세스에서 누수가 생겼다면 (예시: 맵에 저장하고 할당
|
|
해제하지 않음) 대응하는 메인 프로세스의 객체도 누수가 생깁니다. 그래서 remote
|
|
객체를 사용할 땐 메모리 누수가 생기지 않도록 매우 주의해서 사용해야 합니다.
|
|
|
|
참고로 문자열, 숫자와 같은 원시 값 타입은 복사에 의한 참조로 전달됩니다.
|
|
|
|
## 메인 프로세스로 콜백 넘기기
|
|
|
|
메인 프로세스의 코드는 `remote` 모듈을 통해 렌더러 프로세스가 전달하는 콜백
|
|
함수를 받을 수 있습니다. 하지만 이 작업은 반드시 주의를 기울여 사용해야 합니다.
|
|
|
|
첫째, 데드락을 피하기 위해 메인 프로세스로 전달된 콜백들은 비동기로 호출됩니다.
|
|
이러한 이유로 메인 프로세스에 전달된 콜백의 반환 값을 내부 함수에서 언제나
|
|
정상적으로 받을 것이라고 예측해선 안됩니다.
|
|
|
|
예를 들어 메인 프로세스에서 `Array.map` 같은 메서드를 사용할 때 렌더러
|
|
프로세스에서 전달된 함수를 사용해선 안됩니다:
|
|
|
|
```javascript
|
|
// mapNumbers.js 메인 프로세스
|
|
exports.withRendererCallback = (mapper) => {
|
|
return [1, 2, 3].map(mapper)
|
|
}
|
|
|
|
exports.withLocalCallback = () => {
|
|
return [1, 2, 3].map(x => x + 1)
|
|
}
|
|
```
|
|
|
|
```javascript
|
|
// 렌더러 프로세스
|
|
const mapNumbers = require('electron').remote.require('./mapNumbers')
|
|
|
|
const withRendererCb = mapNumbers.withRendererCallback(x => x + 1)
|
|
|
|
const withLocalCb = mapNumbers.withLocalCallback()
|
|
|
|
console.log(withRendererCb, withLocalCb) // [undefined, undefined, undefined], [2, 3, 4]
|
|
```
|
|
|
|
보다시피 동기적인 렌더러 콜백 함수의 반환 값은 예상되지 않은 값입니다. 그리고
|
|
메인 프로세스에서 처리한 함수의 반환 값과 일치하지 않습니다.
|
|
|
|
둘째, 콜백들은 메인 프로세스로 전달, 호출된 이후에도 자동으로 함수의 참조가
|
|
릴리즈 되지 않습니다. 함수 참조는 메인 프로세스에서 GC가 일어나기 전까지 계속
|
|
프로세스에 남아있게 됩니다.
|
|
|
|
다음 코드를 보면 느낌이 올 것입니다. 이 예시는 remote 객체에 `close` 이벤트
|
|
콜백을 등록합니다:
|
|
|
|
```javascript
|
|
const remote = require('remote')
|
|
|
|
remote.getCurrentWindow().on('close', () => {
|
|
// blabla...
|
|
})
|
|
```
|
|
|
|
하지만 이 코드와 같이 등록된 이벤트는 명시적으로 제거하지 않는 이상 콜백 함수의
|
|
참조가 계속해서 메인 프로세스에 남아있게 됩니다. 만약 명시적으로 콜백을 제거하지
|
|
않으면 매 번 창을 새로고침 할 때마다 콜백을 새로 설치합니다. 게다가 이전 콜백이
|
|
제거되지 않고 계속해서 쌓이면서 메모리 누수가 발생합니다.
|
|
|
|
설상가상으로 이전에 등록된 콜백의 컨텍스트가 릴리즈 되고 난 후 (e.g. 페이지
|
|
새로고침) `close` 이벤트가 발생하면 예외가 발생하고 메인 프로세스가 작동
|
|
중지됩니다.
|
|
|
|
이러한 문제를 피하려면 렌더러 프로세스에서 메인 프로세스로 넘긴 함수의 참조를
|
|
사용 후 확실하게 제거해야 합니다. 작업 후 이벤트 콜백을 포함하여 책임 있게
|
|
함수의 참조를 제거하거나 메인 프로세스에서 렌더러 프로세스가 종료될 때
|
|
내부적으로 함수 참조를 제거하도록 설계해야 합니다.
|
|
|
|
## 메인 프로세스의 빌트인 모듈에 접근
|
|
|
|
메인 프로세스의 빌트인 모듈은 `remote` 모듈에 getter로 등록되어 있습니다. 따라서
|
|
`remote` 모듈을 `electron` 모듈처럼 직접 사용할 수 있습니다.
|
|
|
|
```javascript
|
|
const app = remote.app
|
|
```
|
|
|
|
## Methods
|
|
|
|
`remote` 모듈은 다음과 같은 메서드를 가지고 있습니다:
|
|
|
|
### `remote.require(module)`
|
|
|
|
* `module` String
|
|
|
|
Returns `Object` - 메인 프로세스의 `require(module)` 에 의해 반환된 객체.
|
|
|
|
### `remote.getCurrentWindow()`
|
|
|
|
Returns `BrowserWindow` - 현재 웹 페이지가 들어있는
|
|
[`BrowserWindow`](browser-window.md) 객체.
|
|
|
|
### `remote.getCurrentWebContents()`
|
|
|
|
Returns `WebContents` - 현재 웹 페이지의 [`WebContents`](web-contents.md) 객체.
|
|
|
|
### `remote.getGlobal(name)`
|
|
|
|
* `name` String
|
|
|
|
Returns `any` - 메인 프로세스의 전역 변수 `name` (예시: `global[name]`).
|
|
|
|
## Properties
|
|
|
|
### `remote.process`
|
|
|
|
메인 프로세스의 `process` 객체입니다. `remote.getGlobal('process')`와 같습니다.
|
|
하지만 캐시 됩니다.
|
|
|
|
[rmi]: http://en.wikipedia.org/wiki/Java_remote_method_invocation
|
|
[enumerable-properties]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Enumerability_and_ownership_of_properties
|