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