كيفية نشر حزمة Node-API

كيفية نشر إصدار Node-API من حزمة بالإضافة إلى إصدار غير Node-API

تُوضّح الخطوات التالية باستخدام الحزمة iotivity-node:

• أولاً، انشر الإصدار غير Node-API:

  • تحديث الإصدار في package.json. بالنسبة لـ iotivity-node، يصبح الإصدار 1.2.0-2.
  • مراجعة قائمة التحقق من الإصدار (تأكد من أن الاختبارات/العروض التوضيحية/الوثائق على ما يرام).
  • npm publish.

• ثم، انشر إصدار Node-API:

  • تحديث الإصدار في package.json. في حالة iotivity-node، يصبح الإصدار 1.2.0-3. بالنسبة لإصدار الإصدارات، نوصي باتباع مخطط إصدار الإصدارات الأولية كما هو موضح في semver.org على سبيل المثال 1.2.0-napi.
  • مراجعة قائمة التحقق من الإصدار (تأكد من أن الاختبارات/العروض التوضيحية/الوثائق على ما يرام).
  • npm publish --tag n-api.

في هذا المثال، تضمن وسم الإصدار بـ n-api أنه على الرغم من أن الإصدار 1.2.0-3 أحدث من الإصدار المنشور غير Node-API (1.2.0-2)، إلا أنه لن يتم تثبيته إذا اختار شخص ما تثبيت iotivity-node فقط بتشغيل npm install iotivity-node. سيتم تثبيت الإصدار غير Node-API افتراضيًا. سيتعين على المستخدم تشغيل npm install iotivity-node@n api لتلقي إصدار Node-API. لمزيد من المعلومات حول استخدام الوسوم مع npm، راجع "استخدام dist-tags".

كيفية إدخال اعتماد على إصدار Node-API من حزمة

لإضافة إصدار Node-API من iotivity-node كاعتماد، ستبدو package.json هكذا:

"dependencies": {
  "iotivity-node": "n-api"
}

كما هو موضح في "استخدام dist-tags"، على عكس الإصدارات العادية، لا يمكن معالجة الإصدارات المسمّاة بواسطة نطاقات الإصدارات مثل "^2.0.0" داخل package.json. والسبب في ذلك هو أن الوسوم تشير إلى إصدار واحد بالضبط. لذلك، إذا اختار مُحافظ الحزمة وضع علامة على إصدار لاحق من الحزمة باستخدام نفس الوسوم، فستتلقى npm update الإصدار الأحدث. يجب أن يكون هذا مقبولًا، بخلاف أحدث إصدار تم نشره، يجب أن يشير اعتماد package.json إلى الإصدار الدقيق كما يلي:

"dependencies": {
  "iotivity-node": "1.2.0-3"
}