IDE Window: Package Options/ru: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | - | ||
| 2 | - | ||
| 3 | - | ||
| 4 | - | ||
| 5 | - | ||
| 6 | - | ||
| 7 | - | ||
| 8 | - | ||
| 9 | - | ||
| 10 | - | ||
| 11 | - | ||
| 12 | - | ||
| 13 | - | ||
| 14 | - | ||
| 15 | - | ||
| 16 | - | ||
| 17 | - | ||
| 18 | - | ||
| 19 | - | ||
| 20 | - | ||
| 21 | - | ||
| 22 | - | ||
| 23 | - | ||
| 24 | - | ||
| 25 | 1 | ## Использование (Usage) | |
| 26 | 2 | ||
| 27 | 3 | ### Добавление путей к зависимым пакетам и проектам (Add Paths to dependent packages / project) | |
| 28 | 4 | ||
| 29 | - | ||
| 5 | + | Все указанные пути не используются этим пакетом самостоятельно, но они добавляются к соответствующим путям пакета, проекта, который будет пользоваться данным пакетом. Это называется *включенными (inherited)* путями. Например: Пакет A использует пакет B, который использует пакет C. Все настройки пакета C будут добавлены к настройками B **и** A. | |
| 30 | 6 | ||
| 31 | - | ||
| 7 | + | Например почти все пакеты наследуют свой собственный выходной каталог, таким образом любой пакет, который использует данный пакет сможет найти соответствующие файл .ppu. | |
| 32 | 8 | ||
| 33 | - | ||
| 9 | + | Вы сможете увидеть, какие пути добавлены от пакетов через механизм наследования в вашем окне настроек проекта[[IDE Window: Compiler Options/ru|Настройки компилятора]]. | |
| 34 | 10 | ||
| 35 | - | ||
| 11 | + | **Заметка:** IDE нормализует поисковые пути. Например обрезает лишние пробелы в начале и конце и добавляет разделитель путей (windows: \\, все остальные: /). | |
| 36 | 12 | ||
| 37 | 13 | #### Модуль (Unit) | |
| 38 | 14 | ||
| 39 | - | ||
| 15 | + | Эти пути разделяются точкой с запятой. Могут содержать [[IDE Macros in paths and filenames/ru|макросы]], и and добавляются к соответствующим путям всех пакетов/проектов, которые используют данный пакет. Пути *Модуль (unit)* используются IDE и компилятором для поиска файлов с кодом языка паскаль (.pas, .pp, .ppu). По умолчанию имеет значение *\$(PkgOutDir)/* которое является макросом для [[IDE Window: Compiler Options|каталога вывода пакета]]. | |
| 40 | 16 | ||
| 41 | 17 | #### Включаемый (Include) | |
| 42 | 18 | ||
| 43 | - | ||
| 19 | + | То же, что и *Модуль (unit)*, но для включаемый путей *include* - (файлы .inc). | |
| 44 | 20 | ||
| 45 | 21 | #### Объект (Object) | |
| 46 | 22 | ||
| 47 | - | ||
| 23 | + | То же, что и *Модуль (unit)*, но для объектных файлов (.o). | |
| 48 | 24 | ||
| 49 | 25 | #### Библиотека (Library) | |
| 50 | 26 | ||
| 51 | - | ||
| 27 | + | То же, что и *Модуль(unit)*, но для библиотечный путей *library* (файлы для компоновщика). | |
| 52 | 28 | ||
| 53 | 29 | ### Добавление параметров к зависимым пакетам и проектам (Add options to dependent packages and projects) | |
| 54 | 30 | ||
| 55 | 31 | #### Компоновщик (Linker) | |
| 56 | 32 | ||
| 57 | - | ||
| 33 | + | Эти параметры разделяются пробелом, могут содержать макросы и добавляются к настройкам *компоновщика (linker)* всех пакетов/проектов, которые используют данный пакет. Переводы каретки в тексте конвертируются в пробелы. Множественные пробелы рассматриваются как один, исключение - заключённые в двойные кавычки параметры. | |
| 58 | 34 | ||
| 59 | 35 | #### Пользовательские (Custom) | |
| 60 | 36 | ||
| 61 | - | ||
| 37 | + | Эти параметры разделяются пробелом, могут содержать макросы и добавляются к настройкам *пользовательским (custom)* всех пакетов/проектов, которые используют данный пакет. Переводы каретки в тексте конвертируются в пробелы. Множественные пробелы рассматриваются как один, исключение - заключённые в двойные кавычки параметры. | |
| 62 | 38 | ||
| 63 | 39 | ### Проект (Project) | |
| 64 | 40 | ||
| 65 | 41 | #### Добавлять модуль пакета в секцию uses (Add package unit to uses section) | |
| 66 | 42 | ||
| 67 | - | ||
| 43 | + | Если включено, то главный модуль пакета будет добавлен в секцию uses использующего его пакета. Это означает, что все модули пакета будут вкомпилированы в проект, тем самым гарантирую, что все секции инициализации (initialization) всех модулей пакета будут выполнены. Если пакет содержит модули, которые не должны быть включены постоянно, то не включайте эту настройку. | |
| 68 | 44 | ||
| 69 | 45 | ## Описание (Description) | |
| 70 | 46 | ||
| 71 | 47 | ### Описание или аннотация (Description / Abstract) | |
| 72 | 48 | ||
| 73 | - | ||
| 49 | + | Напишите здесь несколько слов о том, что делает пакет. | |
| 74 | 50 | ||
| 75 | 51 | ### Автор (Author) | |
| 76 | 52 | ||
| 77 | - | ||
| 53 | + | Это Вы. | |
| 78 | 54 | ||
| 79 | 55 | ### Лицензия (License) | |
| 80 | 56 | ||
| 81 | - | ||
| 57 | + | Если вы публикуете/распространяете/продаёте ваш пакет, то это будет хорошей идеей добавить лицензионную информацию. | |
| 82 | 58 | ||
| 83 | 59 | ### Версия (Version) | |
| 84 | 60 | ||
| 85 | - | ||
| 61 | + | Здесь озвучены предложения о том, как использовать номера версий: | |
| 86 | 62 | ||
| 87 | - | ||
| 88 | - | ||
| 89 | - | ||
| 90 | - | ||
| 63 | + | - **Старшая (Major)** - добавляйте к этому значению, если компонент был существенно переработан. | |
| 64 | + | - **Младшая (Minor)** - добавляйте к этому значению, если пакет слегка изменил свой API. Например, добавлены новые возможности или публичный метод изменил свои параметры. | |
| 65 | + | - **Релиз (Revision)** - добавляйте к этому значению каждый раз, когда вы публикуете/распространяете ваш пакет. | |
| 66 | + | - **Номер сборки (Build number)** - увеличивайте это значение каждый раз, когда вы пересобираете данный пакет. Данная операция может выполняться автоматически если воспользоваться следующей опцией. | |
| 91 | 67 | ||
| 92 | 68 | #### Автоматически увеличивать версию при сборке (Automatically increment version on build) | |
| 93 | 69 | ||
| 94 | - | ||
| 70 | + | Пока не реализовано. Основная проблема заключается в следующем: Это действие должно выполняться пере компиляцией, из-за макросов. И оно не должно увеличиваться если сборка поломается. | |
| 95 | 71 | ||
| 96 | 72 | ## Встраивание в IDE (IDE Integration) | |
| 97 | 73 | ||
| 98 | 74 | ### Тип пакета (Package Type) | |
| 99 | 75 | ||
| 100 | - | ||
| 101 | - | ||
| 102 | - | ||
| 76 | + | - **Только время разработки (Designtime only)** - Этот пакет используется только во время разработки, другими словами - это только плагин для IDE и он никогда не будет использоваться другими нормальными приложениями. Пакеты времени разработки требуют для своей работы пакет IDEIntf, который содержит в себе функции взаимодействия с IDE. Если вы попытаетесь использовать пакет только для разработки в вашем проекте, IDE станет вас предупреждать об этом. | |
| 77 | + | - **Только время выполнения (Runtime only)** - Этот пакет не предоставляет никаких улучшений в IDE, то есть он не предназначен для установки в IDE. | |
| 78 | + | - **Времени разработки и выполнения (Designtime and Runtime)** - Пакет предоставляет часть возможностей для IDE и часть доступную нормальным приложениям. | |
| 103 | 79 | ||
| 104 | 80 | ### Обновление и пересборка (Update/Rebuild) | |
| 105 | 81 | ||
| 106 | - | ||
| 107 | - | ||
| 108 | - | ||
| 82 | + | - **Автоматически пересобирать при необходимости (Automatically rebuild as needed)** - Каждый раз, когда пакет или проект использующий данный проект (явно или опосредованно) компилируется, IDE проверяет состояние файлов пакета и если какой-нибудь из файлов пакета изменился, то перекомпилирует данный пакет. | |
| 83 | + | - **Автоматически пересобирать при сборке всех (Auto rebuild when rebuilding all)** - То же, что и выше, но автоматическая проверка производится только при операции пересобрать всё (rebuild all). | |
| 84 | + | - **Ручная компиляция (не автоматически) (Manual compilation (never automatically))** - Этот пакет никогда не будет компилироваться автоматически. Вам нужно открыть [[IDE Window: Package Editor|редактор пакетов]] и явно вызвать компиляцию выбранного пакета. Замечание: Некоторые встроенные пакеты вроде FCL и LCL могут быть скомпилированы только специальными способами, такими, как make. | |
| 109 | 85 | ||
| 110 | 86 | ### Путь к файлам FPDoc (FPDoc files path) | |
| 111 | 87 | ||
| 112 | 88 | Содержит путь к файлам FPDoc с документацией пакета. | |
| 113 | 89 | ||
| 114 | 90 | --- | |
| 115 | - | ||
| 91 | + | *From the Free Pascal wiki, page "IDE Window: Package Options/ru", as it stood on 2015-07-03 after a change by FTurtle, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |