שאלות נפוצות לגבי העברה משימוש של התקנה מוטבעת

החל מ-12 ביוני 2018, ההתקנה מהאתר הוצאה משימוש. למידע נוסף, קראו את הפוסט בבלוג Chromium.

שאלות לגבי ציר הזמן

מה ישתנה ב-12 ביוני 2018?

ההתקנה מהאתר תושבת בכל פריט בחנות האינטרנט של Chrome, כמו תוספים ואפליקציות, שפורסם לראשונה החל מ-12 ביוני 2018 ואילך. אם הסטטוס יהיה מושבת, ניסיונות התקנה מוטבעים יופנו אוטומטית לדף הפרטים של הפריט בחנות האינטרנט של Chrome, שם המשתמש יוכל להשלים את ההתקנה. לא יחולו שינויים בפריטים הקיימים בחנות, שפורסמו לראשונה לפני התאריך הזה.

מה ישתנה ב-12 בספטמבר 2018?

ההשבתה תחול על כל הפריטים, ללא קשר לתאריך הפרסום. 100% מניסיונות ההתקנה מהאתר של כל הפריטים יופנו לחנות האינטרנט של Chrome, שם המשתמשים יוכלו להשלים את ההתקנה.

מה צריך לעשות לפני 12 בספטמבר 2018?

אין צורך לשנות דבר, אבל מומלץ לבדוק את תהליך ההתקנה ולהחליף את הקריאה chrome.webstore.install() בניווט ישירות לדף האפליקציה בחנות האינטרנט של Chrome. זה יאפשר לך לוודא שהוא מניב את חוויית המשתמש הטובה ביותר.

אנחנו גם ממליצים לשלב את תג ההורדה החדש של חנות האינטרנט של Chrome בתהליך ההתקנה של האתר.

מה ישתנה בגרסה M71 (דצמבר 2018)?

החל מגרסה M71, Chrome לא יתמוך יותר בשיטה chrome.webstore.install() והקריאה אליה תיכשל. כתוצאה מכך, תהליך ההתקנה באתר לא יהיה תקין. בשלב זה, קריאות ל-API יגרמו ל-JavaScript TypeError. עליך להסיר את כל הקריאות ל-method של ה-API לפני התאריך הזה.

לאחר השבתת ההתקנה המוטבעת

איך ייראה תהליך ההתקנה?

כשבאתר שלכם תתבצע קריאה ל-chrome.webstore.install(), Chrome כבר לא יפעיל מיד תיבת דו-שיח, אלא יפתח כרטיסייה חדשה בחזית לדף הפרטים של חנות האינטרנט של Chrome (כלומר https://chrome.google.com/webstore/detail/EXTENSION_ID). משם המשתמש יכול לבצע את תהליך ההתקנה הרגיל בלחיצה על 'התקנה'. תופיע תיבת דו-שיח שבה תוצג למשתמש בקשה לקרוא את ההרשאות ולהתקין או לבטל. אחרי שתיבת הדו-שיח תיסגר, הכרטיסייה תישאר בחנות האינטרנט של Chrome.

איך אפשר לדעת אם ההתקנה הצליחה?

כשמתקשרים אל chrome.webstore.install(), הכשל של ה-callback יופעל עם הודעת שגיאה על כך שהמשתמש הופנה לחנות האינטרנט של Chrome. לא יצוין אם ההתקנה הצליחה או לא. חשוב לזכור: החל מגרסה 71 של Chrome, קריאות אל chrome.webstore.install() ייכשלו, ולכן ה-coldCallback אף פעם לא יבוצע.

בלי ה-API הזה, האתר עדיין יכול לזהות אם הפריט כבר מותקן על ידי תקשורת בין התוסף לבין האתר. ניתן לעשות זאת באמצעות העברת הודעות דרך התוסף והמאפיין externally_connectable במניפסט.

"externally_connectable": {
  "matches": ["https://www.example.com/*"]
}
// JS running on https://example.com
try {
  chrome.runtime.sendMessage('EXTENSION_ID', MESSAGE, function() {
    if (chrome.runtime.lastError) {
      // Extension is not installed.
    }
  });
} catch (e) {
  // Extension is not installed.
}

מחליפים את מה שכתוב בשדות הבאים:

  • EXTENSION_ID: מזהה התוסף.
  • MESSAGE: מחרוזת ההודעה או האובייקט שיש לשלוח לתוסף.

כיצד ניתן להפעיל דף מידע לאחר ההתקנה?

משתמשים באירוע chrome.runtime ופותחים כרטיסייה חדשה לאחר ההתקנה. הנה דוגמה לשימוש בדף הרקע:

chrome.runtime.onInstalled.addListener(function listener(details) {
  if (details.reason === chrome.runtime.OnInstalledReason.INSTALL) {
    chrome.tabs.create({url: "https://www.example.com/"});
    chrome.runtime.onInstalled.removeListener(listener);
  }
});

האם אוכל לקבל אישור חריג?

לא. שינוי המדיניות הזה חל על כל הפריטים בחנות האינטרנט של Chrome ללא יוצא מן הכלל.