在這個步驟中,您將瞭解:
- Chrome 應用程式的基本構成要素,包括資訊清單檔案和背景指令碼。
- 如何安裝、執行 Chrome 應用程式及進行偵錯。
預計完成這個步驟的時間:10 分鐘。
如要預覽這個步驟中要完成的內容,請向下跳到本頁底部 ↓。
認識 Chrome 應用程式
Chrome 應用程式包含下列元件:
- 資訊清單會指定應用程式的中繼資料。資訊清單會告知 Chrome 您的應用程式、如何啟動應用程式,以及它需要的額外權限。
- 事件頁面 (又稱為「背景指令碼」) 負責管理應用程式生命週期。背景指令碼可讓您註冊特定應用程式事件的事件監聽器,例如啟動和關閉應用程式視窗。
- 所有程式碼檔案都必須封裝在 Chrome 應用程式中,包括 HTML、CSS、JS 和 Native Client 模組。
- 素材資源 (包括應用程式圖示) 必須一併封裝在 Chrome 應用程式中。
建立資訊清單
開啟您最愛的程式碼/文字編輯器,然後建立名為 manifest.json 的檔案:
{
"manifest_version": 2,
"name": "Codelab",
"version": "1",
"icons": {
"128": "icon_128.png"
},
"permissions": [],
"app": {
"background": {
"scripts": ["background.js"]
}
},
"minimum_chrome_version": "28"
}
請注意這份資訊清單會如何描述名為 background.js 的背景指令碼。接下來,您會建立該檔案。
"background": {
"scripts": ["background.js"]
}
這個步驟會在稍後提供應用程式圖示:
"icons": {
"128": "icon_128.png"
},
建立背景指令碼
建立下列檔案,並將其儲存為 background.js:
/**
* Listens for the app launching then creates the window
*
* @see /apps/app.window.html
*/
chrome.app.runtime.onLaunched.addListener(function() {
chrome.app.window.create('index.html', {
id: 'main',
bounds: { width: 620, height: 500 }
});
});
此背景指令碼只會等待應用程式的 chrome.app.runtime.onLaunched 啟動事件,並執行回呼函式:
chrome.app.runtime.onLaunched.addListener(function() {
//...
});
Chrome 應用程式啟動後,chrome.app.window.create() 會使用基本 HTML 網頁 (index.html) 做為來源來建立新的視窗。您將在下一個步驟中建立 HTML 檢視模式。
chrome.app.window.create('index.html', {
id: 'main',
bounds: { width: 620, height: 500 }
});
背景指令碼可能包含其他事件監聽器、視窗、貼文訊息和啟動資料,這些都是事件頁面用來管理應用程式的資料。
建立 HTML 檢視
建立簡易網頁,在螢幕上顯示「Hello World」訊息,並將其儲存為 index.html:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
</head>
<body>
<h1>Hello, let's code!</h1>
</body>
</html>
就像任何其他網頁一樣,您可以在這個 HTML 檔案中加入其他封裝的 JavaScript、CSS 或素材資源。
新增應用程式圖示
按一下滑鼠右鍵,將這張 128x128 圖片儲存至專案資料夾,並命名為 _icon128.png:
您將使用這個 PNG 做為我們的應用程式圖示,使用者會在啟動選單中看到此圖示。
確認您已建立所有檔案
專案資料夾應有以下 4 個檔案:
在開發人員模式中安裝 Chrome 應用程式
使用開發人員模式即可快速載入及啟動應用程式,而不必將應用程式定為發行套件。
- 透過 Chrome 網址列存取 chrome://extensions。
- 勾選「開發人員模式」核取方塊。
- 按一下「載入未封裝的擴充功能」。
- 使用檔案選擇器對話方塊,前往應用程式的專案資料夾,然後選取該資料夾來載入應用程式。
啟動已完成的 Hello World 應用程式
將專案載入為未封裝的擴充功能後,按一下已安裝應用程式旁邊的「Launch」(啟動)。新的獨立視窗應該會開啟:
恭喜,您剛剛建立了新的 Chrome 應用程式!
使用 Chrome 開發人員工具對 Chrome 應用程式進行偵錯
您可以使用 Chrome 開發人員工具檢查、偵錯、稽核及測試應用程式,就像在一般網頁上操作一樣。
變更程式碼並重新載入應用程式 (依序點選右鍵 >「重新載入 App」),檢查開發人員工具控制台是否有任何錯誤 (依序點選「按一下滑鼠右鍵」>「檢查元素」)。
(我們將在步驟 3 中介紹「檢查背景頁面」選項,並設定鬧鐘)。
開發人員工具 JavaScript 控制台可存取應用程式可用的 API。在將 API 呼叫加入程式碼之前,您可以輕鬆測試 API 呼叫:
瞭解詳情
如要進一步瞭解這個步驟介紹的某些 API,請參閱:
- 資訊清單檔案格式 ↑
- 資訊清單 - 圖示 ↑
- Chrome 應用程式生命週期 ↑
- chrome.app.runtime.onLaunched ↑
- chrome.app.window.create() ↑
準備好繼續進行下一步了嗎?請參閱步驟 2 - 匯入現有的網頁應用程式 »