Pdf.js: Задокументируйте, что pdfjs-dist является «ночной» сборкой

Созданный на 5 февр. 2018  ·  15Комментарии  ·  Источник: mozilla/pdf.js

https://github.com/mozilla/pdfjs-dist и https://www.npmjs.com/package/pdfjs-dist явно не показывают, что выпуск представляет собой непрерывную сборку. Документацию, полученную с https://github.com/mozilla/pdf.js/blob/a7c35025fed8beb8f9b93688fff40497c7ad2de0/external/dist/README.md, вероятно, следует изменить, чтобы сделать это более понятным. И в https://mozilla.github.io/pdf.js/getting_started/ четко не указано, что pdfjs-dist не является сборкой стабильного выпуска.

Вот пример путаницы, вызванной этим: https://github.com/mozilla/pdf.js/pull/9385#issuecomment -363030784

Самый полезный комментарий

Где это сидит? Я очень надеюсь, что скоро выйдет версия, совместимая с Webpack 4.

Все 15 Комментарий

Или вместо этого мы могли бы отправлять релизы npm.

релизы npm, пожалуйста! Я бы использовал тег next для всех бета-версий и не использовал тег для стабильных выпусков. На данный момент это почти отраслевой стандарт.

Я немного поработал над этим в https://github.com/mozilla/botio-files-pdfjs/pull/22.

Одна вещь, с которой я не уверен, как справиться, это исправление нашей текущей настройки npm. Я думаю, что переименую ветку 2.0 как next и опубликую более старую версию 1.0 как стабильную, пока мы не выпустим ее. Это может привести к некоторым странностям для тех, кто уже получил версию 2.0 из npm. Открыт для предложений!

Не могу ответить за все сообщество, но, на мой взгляд, изменение стоит того разового волнения.

Я думаю, что это действительно лучшее решение здесь. Более того, если мы выпустим окончательную версию 2.0, она будет иметь более высокий номер версии, так что я думаю (но я могу ошибаться здесь, так как я не очень знаком с внутренней работой NPM), что люди, которые вытащили предыдущую версию, будут затем автоматически обновится до финальной версии 2.0.

О, да. Мы можем просто пометить неокончательные версии с помощью next вместо latest начиная с официальной версии 2.0. Так:

  1. ^1.x.xxx прежнему будут использовать новейшую предварительную версию 1.x — без изменений
  2. ^2.x.xxx получат финальную стабильную версию 2.0 и перестанут получать предварительные версии.
  3. latest получат финальную стабильную версию 2.0 и перестанут получать предварительные версии.

Так что это довольно мило ИМО.

Мы также могли бы дать подсказку людям из пункта 1, застрявшим на предварительном выпуске 1.x, используя npm deprecate , объявив устаревшими все предварительные выпуски 1.x с сообщением типа «Вероятно, вы неосознанно используете нестабильную версию PDF.js. Пожалуйста, понизьте версию до новейшая стабильная версия 1.9.xxx или обновление до совершенно новой версии 2.x. Руководство по обновлению здесь: http://example.com/pdfjsupgradeguide ".

Изменение для ботов теперь объединено.

@brendandahl Есть ли что-то еще, что нужно сделать для этой проблемы, кроме, возможно, перезапуска бота / веб-перехватчика?

Где это сидит? Я очень надеюсь, что скоро выйдет версия, совместимая с Webpack 4.

Вроде так сделано

Да, репозиторий pdfjs-dist больше не меняется после каждой фиксации. Я просто не уверен, что процесс выпуска работал правильно. @brendandahl Разве у вас не было проблем с этим при создании предварительного выпуска? Если есть проблемы, их нужно устранить, потому что, если предварительный выпуск станет окончательным, он также должен быть опубликован в pdfjs-dist .

@тимвандермейдж

у вас есть какие-нибудь планы, когда вы выпустите 2.0? Есть ли какие-либо оставшиеся проблемы с 2.0? https://github.com/mozilla/pdf.js/projects/5

@banyan Вы можете использовать его сейчас:
https://github.com/mozilla/pdf.js/releases/tag/2.0.550

@prohtex , он четко обозначен как предварительный выпуск.

@wojtekmaj Не сказал, что это не предварительный выпуск. Мне сказали, что он будет более или менее функционально таким же, как и релиз. Учитывая, что найти эту ссылку очень сложно, я решил поделиться ею.

Закрытие, так как это сделано.

Была ли эта страница полезной?
0 / 5 - 0 рейтинги

Смежные вопросы

StevenHarlow picture StevenHarlow  ·  29Комментарии

Vanuan picture Vanuan  ·  34Комментарии

collinanderson picture collinanderson  ·  29Комментарии

Rob--W picture Rob--W  ·  34Комментарии

Snuffleupagus picture Snuffleupagus  ·  28Комментарии