الأسئلة الشائعة حول نقل بيانات إيقاف تثبيت مضمّن

اعتبارًا من 12/06/2018، تم إيقاف التثبيت المضمّن نهائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على مدونة Chromium مشاركة.

أسئلة حول المخطّط الزمني

ما الذي سيتغير في 12-06-2018؟

أي عنصر في "سوق Chrome الإلكتروني"، مثل الإضافات والتطبيقات، تم نشره لأول مرة في 12-06-2018 أو بعد هذا التاريخ تعطيل التثبيت المضمّن. "غير مفعّل" يعني أن محاولات التثبيت المضمّن ستكون تتم إعادة توجيهك تلقائيًا إلى صفحة تفاصيل العنصر على سوق Chrome الإلكتروني حيث يمكن للمستخدم لإكمال عملية التثبيت. لن يحدث أي تغيير في ما يتعلّق بالعناصر الحالية التي كانت الأولى في المتجر في المتجر قبل هذا التاريخ.

ما الذي سيتغير في 12-09-2018؟

سيسري الإيقاف على جميع العناصر بغض النظر عن تاريخ النشر. 100% من التثبيت المضمّن ستتم إعادة توجيه محاولات جميع العناصر إلى سوق Chrome الإلكتروني حيث يمكن للمستخدمين إكمال التثبيت.

ما هو الإجراء الذي عليّ اتّخاذه قبل 12-09-2018؟

لا تحتاج إلى تغيير أي إعدادات، ولكننا نقترح عليك مراجعة خطوات التثبيت واستبدال مكالمة chrome.webstore.install() من خلال ميزة التنقّل مباشرةً إلى بطاقة بيانات تطبيقك على "سوق Chrome الإلكتروني" يتيح لك ذلك الآن التأكّد من أنّه يقدّم أفضل تجربة للمستخدم.

نقترح عليك أيضًا دمج شارة التنزيل الجديدة من "سوق Chrome الإلكتروني" في عملية التثبيت على موقعك.

ما الذي سيتغير في M71 (كانون الأول (ديسمبر) 2018)؟

بدءًا من الإصدار M71، لن يتيح Chrome استخدام طريقة chrome.webstore.install() والاتصال. وسيتعذّر إتمام عملية التثبيت، ما يؤدي إلى تعطيل عملية التثبيت على موقعك الإلكتروني. في هذه المرحلة، تطلب البيانات من واجهة برمجة التطبيقات ستعرض رسالة الخطأ TypeError في JavaScript. لذا، عليك إزالة أيّ طلبات بيانات من طريقة واجهة برمجة التطبيقات قبل هذا التاريخ.

بعد إيقاف التثبيت المضمّن

كيف سيبدو تدفق التثبيت؟

عندما يستدعي موقعك الإلكتروني chrome.webstore.install()، لن يشغِّل Chrome مربّع حوار على الفور بعد ذلك. ولكنّه سيفتح بدلاً من ذلك علامة تبويب جديدة في المقدّمة إلى صفحة التفاصيل في "سوق Chrome الإلكتروني" https://chrome.google.com/webstore/detail/EXTENSION_ID). من هناك، يمكن للمستخدم إجراء عملية تثبيت قياسية بالنقر على "تثبيت"، وسيطلب مربع حوار من المستخدم قراءة الأذونات والتثبيت أو الإلغاء. بعد إغلاق مربع الحوار، ستظل علامة التبويب على Chrome السوق الإلكتروني.

كيف يمكنني معرفة ما إذا كانت عملية التثبيت ناجحة؟

عند استدعاء الدالة chrome.webstore.install()، سيتم تشغيل تعذّر معاودة الاتصال مع ظهور خطأ. تفيد بأنّه تمت إعادة توجيه المستخدم إلى "سوق Chrome الإلكتروني". فلن يشير إلى ما إذا كانت تم التثبيت بنجاح أو لا. تذكر أنه بدءًا من الإصدار 71 من Chrome، تبدأ المكالمات لن يتم تنفيذ الإجراء chrome.webstore.install()، وبالتالي لن يتم تنفيذ عملية معاودة الاتصال مطلقًا.

بدون واجهة برمجة التطبيقات هذه، سيظل بإمكان موقعك الإلكتروني اكتشاف ما إذا كان قد سبق تثبيته من خلال التواصل بين الإضافة وموقعك الإلكتروني. ويمكن إجراء ذلك من خلال رسائل الإضافات 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 الإلكتروني" بدون استثناء.