2016年12月29日 星期四

electron 上手筆記

electron 上手筆記

這裡 electron 是說 github 推的跨平台桌面應用程式開發工具,使用 html, css, javascript 開發。

文件、範例哪兒找?

有無簡易模板?

請參閱 quick-start 那份文件,我這裡也略述之。

專案目錄檔案結構

專案名稱/
– package.json
– main.js
– index.html

package.json

package.json 的內容如下:

{
    "name":"專案名稱",
    "version":"0.1.0",
    "main":"main.js"
}

如果沒有 main 這欄,electron 會去找 index.js 來用。

main.js

main.js 的工作是建立 window 以及處理系統事件。(這裡的系統事件指的是 electron 裡的 app 物件事件)

以下是範例:

const {app, BrowserWindow} = require('electron')
const path = require('path')
const url = require('url')

// Keep a global reference of the window object, if you don't, the window will
// be closed automatically when the JavaScript object is garbage collected.
let win

function createWindow () {
  // Create the browser window.
  win = new BrowserWindow({width: 800, height: 600})

  // and load the index.html of the app.
  win.loadURL(url.format({
    pathname: path.join(__dirname, 'index.html'),
    protocol: 'file:',
    slashes: true
  }))

  // Open the DevTools.
  win.webContents.openDevTools()

  // Emitted when the window is closed.
  win.on('closed', () => {
    // Dereference the window object, usually you would store windows
    // in an array if your app supports multi windows, this is the time
    // when you should delete the corresponding element.
    win = null
  })
}

// This method will be called when Electron has finished
// initialization and is ready to create browser windows.
// Some APIs can only be used after this event occurs.
app.on('ready', createWindow)

// Quit when all windows are closed.
app.on('window-all-closed', () => {
  // On macOS it is common for applications and their menu bar
  // to stay active until the user quits explicitly with Cmd + Q
  if (process.platform !== 'darwin') {
    app.quit()
  }
})

app.on('activate', () => {
  // On macOS it's common to re-create a window in the app when the
  // dock icon is clicked and there are no other windows open.
  if (win === null) {
    createWindow()
  }
})

// In this file you can include the rest of your app's specific main process
// code. You can also put them in separate files and require them here.

index.html

index.html 就等於是畫面定義。範例如下:

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8">
    <title>Hello World!</title>
  </head>
  <body>
    <h1>Hello World!</h1>
    We are using node <script>document.write(process.versions.node)</script>,
    Chrome <script>document.write(process.versions.chrome)</script>,
    and Electron <script>document.write(process.versions.electron)</script>.
  </body>
</html>

開發時如何執行程式?

electron 安裝在 global

在專案目錄裡的命令列執行

electron .

electron 安裝在 local

在專案目錄裡的命令列執行

macOS/Linux

$ ./node_modules/.bin/electron .

Windows

$ .\node_modules\.bin\electron .

electron 是來自 binary download

Windows

$ .\electron\electron.exe your-app\

Linux

$ ./electron/electron your-app/

macOS

$ ./Electron.app/Contents/MacOS/Electron your-app/

有沒有現成的範例檔下載?

用 npm 來做:

# Clone the repository
$ git clone https://github.com/electron/electron-quick-start
# Go into the repository
$ cd electron-quick-start
# Install dependencies
$ npm install
# Run the app
$ npm start

2016年12月4日 星期日

[vscode]開發 extension 的豆知識

前置作業

開發 vscode 的 extension,要先知道的是:
* 開發語言是 TypeScript or JavaScript
* 開發電腦要裝 node.js,還有 Yeoman and the Yeoman VS Code Extension generator

npm install -g yo generator-code
yo code

產生起始開發專案

執行命令列 yo code 之後,會讓你選擇使用何種語言開發。
然後回答幾個問題,它就會產生一個目錄,再進去那個目錄裡執行 code .,就開始寫程式。需要一點時間,因為它需要下載相依套件,準備文件內容再啟動 vscode 編輯器。

debug

按 F5。會需要一點時間,它需要編譯相關檔案後,啟動 vscode 測試用編輯器。它的標題會寫[擴充功能開發主機],以標記為它實際是用來測試你寫的程式的。如果你有改程式,建議是在[擴充功能開發主機]按 ctrl-r 會比較快。如果是關掉它再按 F5 就會比較慢。至於文件上說直接按 F5 這招我就試不出來了。但是在[擴充功能開發主機]開著的情況下,有個 ctrl-shift-F5 是重新啟動,也很快速。

文件中有說,直接按 ctrl-r 重載入 會有用是因為 vscode 有為 .ts 的檔案註冊事件,只要有改變就會重新編譯,所以對於開發主機那裡只要重載入(ctrl-r)就行了。

vscode 的擴充功能的 API 也都有連帶放在 yo 所產生的檔案裡。就是 node_modules\vscode\vscode.d.ts

deploy

FileSystemWatcher

  • 一定要裝 .Net 4.5
  • 要監控的 path 那裡,請記得是它是 glob 的字串。要監控目錄,就是目錄再加 *.*

showInformationMessage

目前沒辦法自動消失

String.format

這個東西不在標配裡。在 typescript 也沒有。用幾個網路上找節的目前都無解。正在嘗試組合技。

參考