รันไทม์และหน้าเหตุการณ์ของแอปทำหน้าที่จัดการวงจรของแอป รันไทม์ของแอปจะจัดการการติดตั้งแอป ควบคุมหน้าเหตุการณ์ และปิดแอปได้ทุกเมื่อ หน้าเหตุการณ์จะคอยฟังเหตุการณ์จากรันไทม์ของแอป รวมถึงจัดการสิ่งที่จะเปิดและวิธีเปิด
วิธีการทํางานของวงจร
รันไทม์ของแอปจะโหลดหน้ากิจกรรมจากเดสก์ท็อปของผู้ใช้ และระบบจะเรียกเหตุการณ์ onLaunch() เหตุการณ์นี้จะบอกให้หน้าเหตุการณ์ทราบถึงหน้าต่างที่จะเปิดขึ้นมาและมิติข้อมูลของหน้าต่างนั้น
เมื่อหน้าเหตุการณ์ไม่มี JavaScript ที่ทำงานอยู่ ไม่มีการเรียกกลับที่รอดำเนินการ และไม่มีหน้าต่างที่เปิดอยู่ รันไทม์จะยกเลิกการโหลดหน้าเหตุการณ์และปิดแอป ก่อนที่จะยกเลิกการโหลดหน้าเหตุการณ์ ระบบจะเรียกเหตุการณ์ onSuspend() ซึ่งจะช่วยให้หน้ากิจกรรมมีโอกาสทํางานทำความสะอาดง่ายๆ ก่อนที่แอปจะปิด
สร้างหน้าและกรอบเวลากิจกรรม
แอปทั้งหมดต้องมีหน้ากิจกรรม หน้านี้มีตรรกะระดับบนสุดของแอปพลิเคชันที่ไม่มี UI ของตนเองและมีหน้าที่สร้างหน้าต่างสําหรับหน้าแอปอื่นๆ ทั้งหมด
สร้างหน้ากิจกรรม
หากต้องการสร้างหน้ากิจกรรม ให้ใส่ช่อง "background" ในไฟล์ Manifest ของแอป และใส่ background.js ในอาร์เรย์สคริปต์ สคริปต์ไลบรารีที่ใช้โดยหน้ากิจกรรมต้องเพิ่มลงในฟิลด์ "background" ก่อน
"background": {
"scripts": [
"foo.js",
"background.js"
]
}
หน้ากิจกรรมต้องมีฟังก์ชัน onLaunched() ระบบจะเรียกใช้ฟังก์ชันนี้เมื่อเปิดแอปพลิเคชันด้วยวิธีใดก็ตามต่อไปนี้
chrome.app.runtime.onLaunched.addListener(function() {
// Tell your app what to launch and how.
});
สร้างหน้าต่าง
หน้ากิจกรรมอาจสร้างกรอบเวลาอย่างน้อย 1 กรอบตามดุลยพินิจ โดยค่าเริ่มต้น หน้าต่างเหล่านี้จะสร้างขึ้นด้วยการเชื่อมต่อสคริปต์กับหน้ากิจกรรม และหน้ากิจกรรมจะเขียนสคริปต์ได้โดยตรง
Windows ในแอป Chrome ไม่เชื่อมโยงกับหน้าต่างเบราว์เซอร์ Chrome ใดๆ โดยจะมีกรอบที่ไม่บังคับพร้อมแถบชื่อและตัวควบคุมขนาด รวมถึงรหัสหน้าต่างที่แนะนํา หน้าต่างที่ไม่มีรหัสจะไม่กู้คืนขนาดและตำแหน่งหลังจากการรีสตาร์ท
ต่อไปนี้เป็นตัวอย่างกรอบเวลาที่สร้างจาก background.js
chrome.app.runtime.onLaunched.addListener(function() {
chrome.app.window.create('main.html', {
id: 'MyWindowID',
bounds: {
width: 800,
height: 600,
left: 100,
top: 100
},
minWidth: 800,
minHeight: 600
});
});
รวมถึงข้อมูลการเปิดตัว
คุณอาจต้องจัดการข้อมูลการเปิดตัวในหน้ากิจกรรม ทั้งนี้ขึ้นอยู่กับวิธีเปิดตัวแอป โดยค่าเริ่มต้นจะไม่มีข้อมูลการเปิดแอปเมื่อตัวเปิดแอปเปิดแอป สำหรับแอปที่มีตัวแฮนเดิลไฟล์ คุณต้องจัดการพารามิเตอร์ launchData.items เพื่ออนุญาตให้เปิดแอปด้วยไฟล์
รอรับเหตุการณ์รันไทม์ของแอป
รันไทม์ของแอปจะควบคุมการติดตั้ง การอัปเดต และการถอนการติดตั้งแอป คุณไม่จำเป็นต้องดำเนินการใดๆ เพื่อตั้งค่ารันไทม์ของแอป แต่หน้าเหตุการณ์จะตรวจจับเหตุการณ์ onInstalled() เพื่อจัดเก็บการตั้งค่าในเครื่อง และเหตุการณ์ onSuspend() เพื่อล้างข้อมูลง่ายๆ ก่อนยกเลิกการโหลดหน้ากิจกรรม
การจัดเก็บการตั้งค่าในเครื่อง
chrome.runtime.onInstalled() จะเรียกใช้เมื่อติดตั้งแอปเป็นครั้งแรกหรือเมื่อมีการอัปเดตแอป เมื่อใดก็ตามที่มีการเรียกใช้ฟังก์ชันนี้ ระบบจะเรียกเหตุการณ์ onInstalled หน้าเหตุการณ์สามารถรับฟังเหตุการณ์นี้และใช้ Storage API เพื่อจัดเก็บและอัปเดตการตั้งค่าในเครื่อง (ดูตัวเลือกพื้นที่เก็บข้อมูลด้วย)
chrome.runtime.onInstalled.addListener(function() {
chrome.storage.local.set(object items, function callback);
});
การป้องกันข้อมูลรั่วไหล
ผู้ใช้ถอนการติดตั้งแอปได้ทุกเมื่อ เมื่อถอนการติดตั้งแล้ว จะไม่มีโค้ดที่ทำงานอยู่หรือข้อมูลส่วนตัวเหลืออยู่ ซึ่งอาจทำให้ข้อมูลสูญหายเนื่องจากผู้ใช้อาจถอนการติดตั้งแอปที่มีข้อมูลที่แก้ไขในเครื่องซึ่งไม่ได้ซิงค์ คุณควรเก็บข้อมูลไว้เพื่อป้องกันการสูญหายของข้อมูล
อย่างน้อยที่สุด คุณควรจัดเก็บการตั้งค่าของผู้ใช้ไว้เพื่อให้ผู้ใช้ติดตั้งแอปของคุณอีกครั้ง ข้อมูลของพวกเขาจะยังคงสามารถนำไปใช้ซ้ำได้ เมื่อใช้ Storage API (storage.sync) คุณจะซิงค์ข้อมูลผู้ใช้กับการซิงค์ของ Chrome โดยอัตโนมัติได้
ล้างข้อมูลก่อนปิดแอป
รันไทม์ของแอปจะส่งเหตุการณ์ onSuspend() ไปยังหน้าเหตุการณ์ก่อนที่จะยกเลิกการโหลด หน้าเหตุการณ์จะคอยฟังเหตุการณ์นี้ รวมถึงทํางานทำความสะอาดและบันทึกสถานะก่อนที่แอปจะปิด
เมื่อเหตุการณ์นี้เริ่มทํางาน รันไทม์ของแอปจะเริ่มกระบวนการปิดแอป หากแอปมีหน้าต่างที่เปิดอยู่ ระบบอาจรีสตาร์ทแอปในอนาคตผ่านเหตุการณ์ onRestarted ในกรณีนี้ แอปควรบันทึกสถานะปัจจุบันลงในพื้นที่เก็บข้อมูลถาวรเพื่อให้รีสตาร์ทในสถานะเดิมได้หากได้รับเหตุการณ์ onRestarted แอปมีเวลาเพียงไม่กี่วินาทีในการบันทึกสถานะ หลังจากนั้นระบบจะสิ้นสุดการทำงานของแอป ดังนั้นคุณควรบันทึกสถานะแอปเพิ่มเติมขณะที่แอปทํางานตามปกติ
หลังจากได้รับ onSuspend ระบบจะไม่ส่งเหตุการณ์ไปยังแอปอีก เว้นแต่จะมีการยกเลิกการระงับด้วยเหตุผลบางประการ ในกรณีนี้ ระบบจะส่ง onSuspendCanceled ไปยังแอปและจะไม่ยกเลิกการโหลดแอป
chrome.runtime.onSuspend.addListener(function() {
// Do some simple clean-up tasks.
});