2008-11-10 6 views
11

Я хочу отдать должное всем библиотекам с открытым исходным кодом, которые мы используем в нашем (коммерческом) приложении. Я думал показать HTML-страницу в нашем диалоге. В нашем процессе сборки используется ant, а сторонние библиотеки - в svn.Как отобразить кредиты

Как вы думаете, лучший способ генерации HTML-страницы?

  • Жесткий код HTML-страница?
  • Переключатель зависимостях управления для Apache-плющ и написать какой-нибудь муравей задачу для создания HTML-
  • Использование Maven-ANT-задач и написать какой-нибудь муравей задачу, чтобы генерировать HTML-
  • Используйте Maven только для обработки зависимостей и HTML один раз, загрузите их и скопируйте. Остальное сделано неизменных муравей-скриптов
  • Переключить на maven2 (Эй, босс, я хочу, чтобы перейти к мавена, в течение 1 месяца сборка может быть снова работать ...)
  • ...

Какие элементы должны отображаться в диалоговом окне?

  • Имя библиотеки
  • Версия
  • Лицензия
  • Автор
  • Главная
  • Изменения, внесенные со ссылкой на архив источника
  • ...

Есть некоторые лучше -practise-советы? Некоторые хорошие примеры (приложения с хорошим диалоговым окном, показывающим зависимости)?

ответ

3

Есть две разные вещи, которые необходимо учитывать.

Во-первых, вам может потребоваться определить лицензии стороннего кода. Это часто происходит с файлом THIRDPARTYLICENSE. Sun Microsystems делает это много. Например, посмотрите в каталоге установки для OpenOffice.org. Существуют примеры файлов .txt и .html таких файлов.

Во-вторых, вы можете в краткой форме определить свои зависимости в поле «О» (а также обратиться к файлу информации о лицензии). Я бы удостоверился, что версии появятся в поле «О программе». Одна вещь, которую люди хотят быстро проверить, - это указание на необходимость замены или обновления копии вашего кода, потому что одна из зависимостей вашей библиотеки обнаружила недавно обнаруженную ошибку или уязвимость безопасности.

Таким образом, я предполагаю, что другая вещь, которую вы хотите включить в окошко, - это способ найти сайт поддержки и любые уведомления, имеющие важное значение для пользователей конкретной версии (независимо от того, есть ли у вас положение в приложении для проверки on-line для обновлений).

3

Задача Ant - это лучший способ. Мы делаем аналогичную вещь в одном из наших проектов. Все библиотеки с открытым исходным кодом присутствуют в указанной папке. Задача Ant читает манифест этих библиотек, версий и т. Д. И генерирует HTML-копии, копирует их в другую указанную папку, откуда ее берет веб-контейнер.

+0

И что вы будете делать, если манифест библиотеки jar не содержит какой-либо информации? – 2008-11-10 15:32:08

2

Создание страницы с каждой сборкой было бы расточительным, если библиотеки не собирались часто меняться. Варианты библиотек могут меняться, но в реальных библиотеках этого нет. Простое создание HTML-страницы было бы самым простым выходом, но это еще одна боль в голове обслуживания. Создайте его один раз и включите его в пакет. Сценарий всегда можно запустить снова в случае внесения каких-либо изменений в библиотеки (обновление версий, добавление новых библиотек).