Чи слід зберігати бібліотеки, на які покладається програма, у джерелі керування? Одна частина мене каже, що це потрібно, а інша частина каже "ні". Неправильно додавати бібліотеку розміром 20 Мб, яка перекриває весь додаток лише тому, що ти покладаєшся на пару функцій з нього (хоча і досить сильно). Чи слід просто зберігати jar / dll або, можливо, навіть розподілений zip / tar проекту?
Що роблять інші люди?
Відповіді:
Окрім того, що у вашому сховищі є сторонні бібліотеки, варто робити це таким чином, щоб було легко відстежувати та об’єднувати майбутні оновлення бібліотеки (наприклад, виправлення безпеки тощо). Якщо ви використовуєте Subversion, використання належної гілки постачальника варто.
Якщо ви знаєте, що в пеклі буде холодний день, перш ніж ви будете модифікувати код третьої сторони, тоді (як сказав @Matt Sheppard) зовнішній сенс має сенс і дає вам додаткову перевагу, завдяки якій стає дуже легко перейти найновіша версія бібліотеки, якщо оновлення безпеки або обов’язкова нова функція роблять це бажаним.
Крім того, ви можете пропустити зовнішні дані при оновленні бази коду, заощаджуючи тривалий повільний процес завантаження, якщо вам потрібно.
@Stu Thompson згадує про зберігання документації тощо у контролі джерел. У більших проектах я зберігав цілу папку "клієнти" у контролі джерел, включаючи рахунки / рахунки / протоколи засідань / технічні характеристики тощо. Хоча, пам’ятайте, пам’ятайте зберігати їх у РОЗДІЛЬНОМ сховищі від того, який ви зробите доступним для: інших розробників; клієнт; ваш "вигляд джерела браузера" ... кашель ... :)
зберігайте все, що вам знадобиться для побудови проекту, через 10 років. Я зберігаю весь zip-розподіл будь-якої бібліотеки, про всяк випадок
Редагувати за 2017 рік: Ця відповідь погано постаріла :-). Якщо ви все ще використовуєте щось старе, як мураха або макіяж, вищезазначене все ще стосується. Якщо ви використовуєте щось більш сучасне, наприклад maven або graddle (або Nuget на .net, наприклад), з управлінням залежностями, вам слід запустити сервер управління залежностями, на додаток до вашого сервера управління версіями. Поки у вас є хороші резервні копії обох, і ваш сервер управління залежностями не видаляє старі залежності, ви повинні бути в порядку. Приклад сервера керування залежностями див., Наприклад, Sonatype Nexus або JFrog Artifcatory , серед багатьох інших.
Не зберігайте бібліотеки; вони не є строго кажучи частиною вашого проекту і марно займають місце у вашій системі контролю редакції. Однак використовуйте maven (або Ivy для побудови мурашок), щоб відстежувати, які версії зовнішніх бібліотек використовує ваш проект. Вам слід запустити дзеркало репо у вашій організації (яке резервне копіювання), щоб забезпечити наявність залежностей під вашим контролем. Це повинно дати вам найкраще з обох світів; зовнішні банки поза вашим проектом, але все одно надійно доступні та доступні централізовано.
Ми зберігаємо бібліотеки в елементі керування вихідними кодами, тому що хочемо мати можливість побудувати проект, просто перевіривши вихідний код та запустивши сценарій збірки. Якщо ви не можете отримати останні версії та побудувати за один крок, тоді у вас виникнуть проблеми лише пізніше.
ніколи не зберігайте свої сторонні двійкові файли під контролем джерела. Системи керування джерелами - це платформи, які підтримують одночасний обмін файлами, паралельну роботу, об’єднання зусиль та історію змін. Керування джерелом не є FTP-сайтом для двійкових файлів. Асамблеї третіх сторін НЕ є вихідним кодом; вони змінюються, можливо, двічі за SDLC. Бажання мати змогу витерти робочу область чистою, витягнути все з контролю джерела та побудови не означає, що сторонні збори повинні бути застрягли в керуванні джерелами. Ви можете використовувати сценарії побудови для управління витягуванням сторонніх збірок із сервера розподілу. Якщо вас турбує контроль того, яка гілка / версія вашої програми використовує певний сторонній компонент, тоді ви можете керувати цим також за допомогою сценаріїв збірки. Люди згадували Maven для Java, і ви можете зробити щось подібне з MSBuild для .Net.
Я зазвичай зберігаю їх у сховищі, але я співчуваю вашому бажанню зменшити розмір.
Якщо ви не зберігаєте їх у сховищі, їх абсолютно потрібно якось архівувати та версувати, а ваша система збірки повинна знати, як їх отримати. Багато людей у світі Java, здається, використовують Maven для автоматичного отримання залежностей, але я не використовував I, тому я не можу порекомендувати за чи проти.
Одним хорошим варіантом може бути ведення окремого сховища сторонніх систем. Якщо ви використовуєте Subversion, ви можете використовувати зовнішню підтримку Subversion для автоматичного перевірки бібліотек з іншого сховища. В іншому випадку я б запропонував зберегти внутрішній анонімний FTP-сервер (або подібний) сервер, з якого ваша система збору може автоматично отримувати вимоги. Очевидно, ви захочете переконатись, що ви зберігаєте всі старі версії бібліотек і маєте там все резервне копіювання разом із вашим сховищем.
У мене є внутрішнє сховище, схоже на Maven, де зберігаються всі сторонні бібліотеки (не тільки бібліотеки, але їх відповідний вихідний розподіл із документацією, Javadoc та іншим). Причиною є наступне:
Я ставлю все, крім JDK та IDE, у керування джерелами.
Філософія Тоні - це звук. Не забувайте сценарії створення бази даних та сценарії оновлення структури даних. Перш ніж виходити вікі, я навіть зберігав нашу документацію в контролі джерел.
Я вважаю за краще зберігати сторонні бібліотеки у сховищі залежностей (наприклад, Artifactory з Maven ), а не зберігати їх у Subversion.
Оскільки сторонні бібліотеки не керуються і не керуються версіями, як вихідний код, не має сенсу змішувати їх. Віддалені розробники також оцінюють відсутність необхідності завантажувати великі бібліотеки за повільним посиланням WPN, коли вони можуть отримати їх простіше з будь-якої кількості загальнодоступних сховищ.
У попереднього роботодавця ми зберігали все необхідне для створення додатків у контролі джерел. Обертання нової версії машини було питанням синхронізації з джерелом управління та встановлення необхідного програмного забезпечення.
Зберігайте сторонні бібліотеки у вихідному контролі, щоб вони були доступні, якщо ви переглядаєте свій код в новому середовищі розробки. Будь-які команди "включення" або побудови, які ви можете мати у сценаріях побудови, також повинні посилатися на ці "локальні" копії.
Окрім того, що код або бібліотеки, від яких ви залежате, завжди будуть вам доступні, це також повинно означати, що код (майже) готовий до створення на новому ПК чи обліковому записі користувача, коли нові розробники приєднуються до команди.
Зберігайте бібліотеки! Сховище має бути знімком того, що потрібно для побудови проекту в будь-який момент часу. Оскільки проект вимагає іншої версії зовнішніх бібліотек, ви захочете оновити / перевірити новіші версії цих бібліотек. Таким чином, ви зможете отримати всю потрібну версію зі старим знімком, якщо вам доведеться виправити старіший випуск тощо.
Особисто я маю папку залежностей як частину своїх проектів і зберігаю там бібліотеки, на які посилаються.
Я вважаю, що це полегшує життя, оскільки я працюю над низкою різних проектів, часто із взаємозалежними частинами, які потребують однакової версії бібліотеки, тобто не завжди можливо оновити до останньої версії даної бібліотеки.
Маючи всі залежності, які використовуються під час компіляції для кожного проекту, це означає, що через кілька років, коли все рухається далі, я все ще можу будувати будь-яку частину проекту, не турбуючись про порушення інших частин. Оновлення до нової версії бібліотеки - це просто випадок заміни файлу та відновлення відповідних компонентів, не надто складних для управління, якщо це необхідно.
Сказавши це, я вважаю, що більшість бібліотек, на які я посилаюся, відносно невеликі, важать близько декількох сотень кб, рідко бувають більшими, що робить для мене меншою проблемою просто закріпити їх за контролем джерел.
Використовуйте підпроекти git та посилання з головного сховища git сторонніх бібліотек, або (якщо у нього немає) створіть нове сховище git для кожної необхідної бібліотеки. Немає жодної причини, чому ви обмежуєтесь лише одним сховищем git, і я не рекомендую використовувати чужий проект як лише каталог у своєму власному.
зберігайте все, що потрібно для побудови проекту, щоб ви могли перевірити його та побудувати, не роблячи нічого.
(і, як хтось, хто зазнав болю - будь ласка, збережіть копію всього, що потрібно для встановлення елементів керування та роботи на платформі розробника. Одного разу я отримав проект, який міг побудувати - але без файлу встановлення та ключів reg, ви не могли не вносити жодних змін у макет стороннього контролю. Це було цікаво переписати)
Ви повинні зберігати все необхідне для побудови проекту. Крім того, різні версії коду можуть мати різну залежність від сторонніх виробників. Ви захочете розгалужити свій код на версію обслуговування разом із незалежними залежностями ...
Особисто те, що я зробив і мені до цього часу сподобались результати, - це зберігати бібліотеки в окремому сховищі, а потім посилатися на кожну бібліотеку, яка мені потрібна в інших сховищах, за допомогою функції Subversion svn: externals. Це чудово працює, тому що я можу зберігати версійні копії більшості наших бібліотек (в основному керованих .NET-збірок) у вихідному контролі, не збільшуючи при цьому розмір нашого основного сховища вихідного коду. Маючи збірки, що зберігаються у сховищі, таким чином, це робить так, що на сервері збірки їх не потрібно встановлювати для створення збірки. Я скажу, що отримання збірки для успіху за відсутності встановлення Visual Studio було справжньою справою, але тепер, коли ми працюємо, ми цим задоволені.
Зауважте, що в даний час ми не використовуємо багато комерційних сторонніх контрольних пакетів або подібні речі, тому ми не стикалися з проблемами ліцензування, де може знадобитися фактично встановити SDK на сервер збірки, але я бачу, де це може легко стати проблемою. На жаль, у мене немає рішення для цього, і я буду планувати його вирішення, коли вперше на нього натраплю.