Đảm bảo dễ cài đặt

Pete LePage

Theo dõi sự kiện beforeinstallprompt

Khi trình duyệt kích hoạt sự kiện beforeinstallprompt, đó là dấu hiệu cho thấy Ứng dụng web có thể được cài đặt và nút cài đặt có thể được hiển thị cho người dùng. Sự kiện beforeinstallprompt được kích hoạt khi ứng dụng đáp ứng các tiêu chí về khả năng cài đặt.

Việc ghi lại sự kiện này cho phép nhà phát triển tuỳ chỉnh quá trình cài đặt và nhắc người dùng cài đặt khi họ cho rằng đó là thời điểm thích hợp nhất.

  1. Nhấp vào Trộn để chỉnh sửa để có thể chỉnh sửa dự án.
  2. Thêm trình xử lý sự kiện beforeinstallprompt vào đối tượng window.
  3. Lưu event dưới dạng biến toàn cục; chúng ta sẽ cần biến này sau để hiện lời nhắc.
  4. Hiện nút cài đặt.

Mã:

window.addEventListener('beforeinstallprompt', (event) => {
  // Prevent the mini-infobar from appearing on mobile.
  event.preventDefault();
  console.log('👍', 'beforeinstallprompt', event);
  // Stash the event so it can be triggered later.
  window.deferredPrompt = event;
  // Remove the 'hidden' class from the install button container.
  divInstall.classList.toggle('hidden', false);
});

Xử lý thao tác nhấp vào nút cài đặt

Để hiện lời nhắc cài đặt, hãy gọi prompt() trên sự kiện beforeinstallprompt đã lưu. Việc gọi prompt() được thực hiện trong trình xử lý lượt nhấp vào nút cài đặt vì prompt() phải được gọi từ một cử chỉ của người dùng.

  1. Thêm một trình xử lý sự kiện nhấp cho nút cài đặt.
  2. Gọi prompt() trên sự kiện beforeinstallprompt đã lưu.
  3. Ghi lại kết quả của câu lệnh.
  4. Đặt sự kiện beforeinstallprompt đã lưu thành giá trị rỗng.
  5. Ẩn nút cài đặt.

Mã:

butInstall.addEventListener('click', async () => {
  console.log('👍', 'butInstall-clicked');
  const promptEvent = window.deferredPrompt;
  if (!promptEvent) {
    // The deferred prompt isn't available.
    return;
  }
  // Show the install prompt.
  promptEvent.prompt();
  // Log the result
  const result = await promptEvent.userChoice;
  console.log('👍', 'userChoice', result);
  // Reset the deferred prompt variable, since
  // prompt() can only be called once.
  window.deferredPrompt = null;
  // Hide the install button.
  divInstall.classList.toggle('hidden', true);
});

Theo dõi sự kiện cài đặt

Cài đặt Ứng dụng web thông qua nút cài đặt chỉ là một cách để người dùng có thể cài đặt ứng dụng. Họ cũng có thể sử dụng trình đơn của Chrome, thanh thông tin thu nhỏ và thông qua một biểu tượng trong thanh địa chỉ. Bạn có thể theo dõi tất cả các cách cài đặt này bằng cách theo dõi sự kiện appinstalled.

  1. Thêm trình xử lý sự kiện appinstalled vào đối tượng window.
  2. Ghi lại sự kiện cài đặt vào số liệu phân tích hoặc cơ chế khác.

Mã:

window.addEventListener('appinstalled', (event) => {
  console.log('👍', 'appinstalled', event);
  // Clear the deferredPrompt so it can be garbage collected
  window.deferredPrompt = null;
});

Tài liệu đọc thêm

Xin chúc mừng, giờ đây bạn có thể cài đặt ứng dụng của mình!

Sau đây là một số việc khác mà bạn có thể làm: