Installing Lazarus on macOS/ru: what changed

Revision 3 to 4. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		Установка Lazarus на Mac не особенно сложна, но очень важно выполнить установку в правильном порядке. Пропуск шагов почти наверняка приведет к плачу Ярославны. Вкратце, вот что вы должны сделать -
2	2
3	3		1. Загрузить и установить Xcode.
4	4		2. Установить глобальные инструменты командной строки для Xcode.
5	5		3. Установить Free Pascal Compiler и исходники FPC
6	6		4. Установить Lazarus
7	7		5. Настроить LLDB - поставляемый (и подписанный) Apple отладчик от Lazarus.
8	8
9	9		> Note: если вы устанавливаете версии Lazarus до 2.0.0, вам почти наверняка понадобится gdb, см. раздел [[Legacy Information: Installing Lazarus on Mac\|Legacy]].
10	10
11	11		## Установка
12	12
13	13		В подробных инструкциях предполагается, что на вашем Mac установлена последняя версия macOS, последняя версия Xcode от Apple и последняя версия Lazarus. Внизу страницы, под устаревшей документацией, вы увидите более старую информацию, которая может иметь значение, если вы используете старые компоненты. Вы можете помочь, заменив устаревшую информацию, либо удалив ее, либо, если это может помочь кому-то, работающему с унаследованным проектом, переместить ее в конец страницы.
14	14
15	15		В общем, речь идет об использовании набора виджетов Carbon и Cocoa. Хотя Carbon все еще можно считать немного более стабильным, на момент выпуска 2.0.0 64-битное Cocoa очень близко \[к стабильному\] и, безусловно, его следует учитывать. Carbon намеренно (Apple) ограничен 32 битами, и мы знаем, что следующая версия MacOSX, вероятно, не будет его поддерживать.
16	16
17	17		### Шаг 1. Загрузка Xcode (необязательно).
18	18
19	19		Xcode — это загрузка 12ГБ архива, которая займет после распаковки 16ГБ дискового пространства. Имеет смысл заружать и устанавливать полную среду разработки Xcode, только если вам нужны:
20	20
21	21		- SDK для iOS, iPadOS, watchOS и tvOS; или
22	22		- для проверки и загрузки приложений в Mac App Store; или
23	23		- [[Notarization for macOS 10.14.5+/ru\|нотариально заверять]] приложения для распространения за пределами Mac App Store.
24	24
25	25		Xcode 11.3.1 для использования в macOS 10.14 Mojave теперь необходимо устанавливать, загрузив его из [Apple Developer Connection](http://developer.apple.com/) (ADC), для чего требуется бесплатная регистрация. Xcode 12.4.x для использования в macOS 10.15 Catalina и более поздних версиях можно установить из магазина приложений [Mac App store](https://apps.apple.com/us/genre/mac-developer-tools/id12002?mt=12). Обратите внимание, что вы должны сначала переместить все старые версии Xcode из папки «Приложения» в корзину или переименовать приложение Xcode (например, Xcode.app в Xcode_1014.app). Затем вы можете выбрать, какую версию Xcode использовать с помощью утилиты командной строки `xcode-select`. Откройте Applications \> Utilities \> Terminal (Приложения \> Инструменты \> Терминал) и введите`man xcode-select` для показа страниц руководства по этой утилите.
26	26
27	27		Старые системы:
28	28
29	29		Инструменты разработчика Xcode можно установить с исходных установочных дисков macOS или более новой копии, загруженной из [Apple Developer Connection](http://developer.apple.com/) (ADC), для чего требуется бесплатная регистрация. Загрузите файл Xcode, он окажется в вашем каталоге загрузок в виде zip-файла. Нажмите на нее. Он разархивируется в каталог Downloads(Загрузки). Вам может повезти, а может быть и нет. Другие пользователи увидят путь к нему, но не смогут его использовать. А это - непорядок. Чтобы исправить это недоразумение, я переместил свой, а затем указал `xcode-select`, куда он был перемещен (в терминале) -
30	30
31	31		``` bash
32	32		mv Downloads/Xcode.app /Developer/.
33	33		sudo xcode-select -s /Developer/Xcode.app/Contents/Developer
34	34		```
35	35
36	36		### Шаг 2. Инструменты командной строки Xcode
37	37
38	38		Это раздел показан как отдельный шаг, потому что это действительно отдельный шаг. Не путайте эти автономные инструменты командной строки с внутренними инструментами командной строки Xcode, о которых графический интерфейс Xcode сообщит вам, что они уже установлены, если вы установили полный пакет Xcode на шаге 1. FPC не может использовать эти внутренние инструменты командной строки Xcode без изменений конфигурации ( подробности см. в [[Xcode]]).
39	39
40	40		Сделайте следующее, это быстро и легко для всех версий macOS до Catalina 10.15 включительно:
41	41
42	42		``` bash
43	43		sudo xcode-select --install
44	44		sudo xcodebuild -license accept
45	45		```
46	46
47	47		Для Big Sur 11.x и более поздних версий вам нужно ввести только первую из двух приведенных выше команд, если вы также не установили полный пакет Xcode. Если вы установили только инструменты командной строки, вам не следует вводить команду xcodebuild.
48	48
49	49		Если у вас возникли проблемы с установкой инструментов командной строки с использованием этого метода командной строки (например, программа установки зависает при «поиске программного обеспечения»), вы также можете загрузить и установить пакет инструментов командной строки, зайдя на [Apple Developer Site](https://developer.apple.com/download/more/?=for%20Xcode) и загрузив и установив образ диска Command Line Tools for Xcode.
50	50
51	51		### Шаг 3 Бинарные файлы FPC и исходный код FPC
52	52
53	53		> Note: Для установки Apple Silicon/AArch64/M1, если вы устанавливаете FPC 3.2.2 (Lazarus 2.2RCx или 2.2.0 или более поздние версии), вам не нужно компилировать собственную версию FPC для Apple Silicon, поскольку FPC 3.2.2 для macOS универсальный двоичный файл, содержащий исполняемые файлы Intel и aarch64. Если вы устанавливаете более раннюю, чем 3.2.2, версию FPC, обратитесь к [[macOS Big Sur changes for developers\|этим инструкциям]] для создания собственного компилятора Apple Silicon Free Pascal после установки 64-разрядного двоичного файла Intel и исходных пакетов для FPC.
54	54
55	55		Загрузите и установите официальный пакет двоичных файлов FPC и отдельный пакет исходного кода FPC из [области файлов Lazarus IDE](https://sourceforge.net/projects/lazarus/files/).
56	56
57	57		Когда вы доберетесь до области файлов Lazarus IDE:
58	58
59	59		1. Выберите правильную версию вашей операционной системы. Подавляющее большинство пользователей Mac теперь должны выбирать 64-битные пакеты в каталоге Lazarus macOS x86-64. Каждый компьютер Mac с конца 2006 года поддерживает 64-разрядную версию. Тот факт, что Apple полностью отказалась от 32-битной поддержки в macOS 10.15 Catalina (выпущенной в октябре 2019 года), является еще одной причиной для выбора 64-битных пакетов.
60	60		2. Выберите версию Lazarus, которую вы хотите установить, и вам будут представлены два бинарных и исходных пакета FPC для загрузки.
61	61
62	62		Эти установочные пакеты создаются разработчиками FPC/Lazarus и отслеживают официальные выпуски. Поскольку эти установочные пакеты не одобрены Apple, вам нужно, удерживая нажатой клавишу Control, щелкнуть пакет, выбрать «Открыть» и подтвердить, что вы хотите установить его от неизвестного разработчика (Unknown Developer).
63	63
64	64		На этом этапе вы можете попробовать простой и быстрый тест FPC — [[Installing the Free Pascal Compiler\|Тестирование установки FPC]].
65	65
66	66		### Установка Lazarus
67	67
68	68		Крайне важно, чтобы совместимый компилятор Free Pascal (FPC) и его исходный код был установлен перед установкой Lazarus IDE.
69	69
70	70		> Note: Для установки на Apple Silicon/AArch64 обратитесь к инструкциям Lazarus Fixes 2.2 или Lazarus development, чтобы создать собственную IDE Lazarus. Перейдите к инструкциям по сборке и используйте загрузку исходного кода Lazarus Fixes 2.2/Lazarus development по своему усмотрению.
71	71
72	72		Загрузите и установите Lazarus IDE из [области файлов Lazarus IDE](https://sourceforge.net/projects/lazarus/files/). Когда вы доберетесь до этой области файлов, выберите правильную версию вашей операционной системы. Подавляющее большинство пользователей Mac теперь должны выбирать 64-битные пакеты в каталоге Lazarus macOS x86-64. Каждый компьютер Mac с конца 2006 года поддерживает 64-разрядную версию. Тот факт, что Apple полностью отказалась от 32-битной поддержки в macOS 10.15 Catalina (выпущенной в октябре 2019 года), является еще одной причиной для выбора 64-битных пакетов.
73	73
74	74		### Настройка отладчика
75	75
76	76		В версиях Lazarus 1.8.4 и более ранних версиях вам нужно было использовать gdb в качестве отладчика, медленно устанавливать и тяжело подписывать. Начиная с Lazarus 2.0.0 вы можете (и должны) использовать LLDB, отладчик, предоставляемый Apple, подпись \[для которого\] не требуется.
77	77
78	78		Предполагая, что вы установили все необходимое и запустили Lazarus, остается только настроить отладчик. Если вы не сделаете этого сейчас, Lazarus попытается использовать GDB и потерпит неудачу.
79	79
80	80		Сначала нажмите Tools(Инструменты)-\>Options(Параметры)-\>Debugger(Отладчик). В правом верхнем углу открытого окна есть надпись "Debugger type and path"(Тип и путь отладчика), вы должны задать оба \[значения\]. Выберите "LLDB debugger (with fpdebug) (Beta)"(Отладчик LLDB (с помощью fpdebug) (Beta)).
81	81
82	82		![](/wiki-images/d/d5/Set_Debugger2.png)
83	83
84	84		Если его нет в списке выбора, см. ниже (Установка LazDebuggerFpLLdb). Обратите внимание, что изображение выше имеет путь к LLDB, который может отличаться от вашего, в зависимости от того, где были установлены инструменты XCode, в моем случае /Library. Сохраните эти настройки, и теперь вы можете попытаться скомпилировать практически пустую программу, которую Lazarus любезно предоставил для вас (щелкните маленький зеленый треугольник в верхнем левом углу).
85	85
86	86		Далее вы видите загадочный вопрос, см. изображение ниже. Выберите "Debug Format"(формат отладки) из предложенных -
87	87
88	88		![](/wiki-images/0/03/Set_Dwarf.png)
89	89
90	90		Martin_fr (человек, который дал нам этот интерфейс между Lazarus и LLDB) предлагает вам использовать "dwarf3". Затем вам нужно ввести свой пароль: MacOSX хитроумна, потому что одно приложение мешает другому. В этом случае это хорошо!
91	91
92	92		#### Дополнительная информация по использованию LLDB
93	93
94	94		В [этой ветке](https://forum.lazarus.freepascal.org/index.php/topic,42869.0.html) форума появляется много информации об использовании LLDB. Вот еще несколько самоцветов от Martin_fr:
95	95
96	96		В случае непредвиденных проблем стоит попробовать "dwarf with sets" взамен используемому "dwarf3".
97	97
98	98		Параметр "debug info" влияет только на модули непосредственно в вашем проекте. Однако модули в пакетах также могут иметь отладочную информацию. Это может быть
99	99
100	100		- установка в пакете
101	101		- для многих, но не для всех пакетов в меню Tools(Сервис) \> Configure build Lazarus(Настройка сборки Lazarus)
102	102		- project settings (настройки проекта) \> [[IDE Window: Compiler Options\|Дополнения и переопределения]]
103	103
104	104		Если вы измените настройки для пакета, вы также можете проверить, в какой пакет вы планируете перейти. Пакет, в который вы не входите, не требует отладочной информации. Если вы используете тип из пакета (такой, как TForm из LCL), то достаточно, чтобы ваш модуль (в котором вы объявляли переменную и(или) использовали переменную для включения типа) имел отладочную информацию. Уменьшение количества пакетов с отладочной информацией (в том числе тех, которые по умолчанию имеют отладочную информацию) может сократить время запуска отладчиков.
105	105
106	106		Также, возможно, стоит сравнить (не проверено) время запуска отладчиков для тех же настроек, только изменив флажок "use external debug info" (использовать внешнюю информацию отладки).
107	107
108	108		Это должно быть установлено только в вашем проекте. Если установлен в вашем проекте, это повлияет на все пакеты. (Если он установлен в пакете, он ничего не сделает/по крайней мере, не должен ...)
109	109
110	110		#### Установка LazDebuggerFpLLdb
111	111
112	112		Если вы установились из исходного кода и \[при этом\] использовали параметр bigide \[утилиты make\], то правильный отладчик будет установлен, как пакет, и \[сразу будет\] готов к работе. Однако, если вы установили другим способом, \[отладчика\] там может и не оказаться. На главном экране IDE выберите Packages(Пакеты) -\> Install/Uninstall Packages (Установить/удалить пакеты). Show - это два списка пакетов, слева - список уже установленных, справа - доступных для установки. Ищите LazDebuggerFpLldb (именно его, есть некоторые схожие названия, но менее подходящие пакеты). Если он справа, щелкните его, нажмите "Install Selection" (Установить выделенное), а затем "Save and rebuild IDE" (Сохранить и пересобрать IDE). Это займет немного времени, IDE выключится и перезапустится, и все должно быть хорошо. Теперь вернитесь на страницу и продолжите настройку отладчика.
113	113
114	114		## Cocoa 64-бит в сравнении с Carbon 32-бит
115	115
116	116		Использование 64-битной платформы Cocoa от Apple теперь, несомненно, является будущим для Mac. 32-разрядная платформа Apple Carbon, хотя больше не разрабатывается, но работает почти так же, как и ожидалось. Однако мы бы порекомендовали сначала попробовать Cocoa, поскольку Apple прекратила поддержку 32-разрядных приложений и 32-разрядной платформы Carbon в macOS 10.15 Catalina (октябрь 2019 г.) .
117	117
118	118		Можно собрать Cocoa-версию Lazarus IDE, начиная с версии 2.0.0 и выше. Также можно собрать Carbon-версию Lazarus IDE (если вы не используете macOS 10.15 Catalina или более позднюю версию) и использовать ее для создания 64-битных двоичных файлов Cocoa.
119	119
120	120		Чтобы создавать приложения Cocoa в Carbon или Cocoa IDE, вам необходимо установить Target для 64-битного процессора и выбрать набор виджетов Cocoa:
121	121
122	122		- Откройте свой проект с помощью Lazarus и в меню выберите Project \> Project Options.
123	123		- На панели "Config and Target" (Конфигурация и цель) установите для "Target CPU family"(Целевое семейство ЦП) значение "x86_64" (Intel) или "aarch64" (Apple M1).
124	124		- На панели "Config and Target" (Конфигурация и цель), если "Current LCL widgetset"(Текущий набор виджетов LCL) не установлен для Cocoa, нажмите "Select another LCL widgetset" (Выбрать другой набор виджетов LCL), который перенесет вас на панель "Additions and Overrides" (Дополнения и перекрытия), где вы можете нажать выпадающее меню "Set LCLWidgetType"(Присвоить "LCLWidgetType") и установите значение "Cocoa"
125	125		- Убедитесь, что в разделе Tools (Сервис) \> Options(Настройки) (\> Preferences (Параметры) для Lazarus в версии 2.2.0 и более поздних версиях) для параметра "Compiler Executable" (Исполнимый файл компилятора) установлено значение «/usr/local/bin/fpc», чтобы получить 64-разрядные приложения.
126	126		- Теперь скомпилируйте свой проект и, пожалуйста, сообщите о любых проблемах, с которыми вы столкнулись.
127	127
128	128		## Матрица совместимости FPC + Lazarus
129	129
130	130		Не всякая комбинация \[версий\] Lazarus и Free Pascal совместима с любой установкой macOS. Пожалуйста, обратитесь к следующей таблице, чтобы найти правильную версию для вашей среды разработки:
131	131
132	132		## Установка невыпущенных версий Lazarus IDE
133	133
134	134		Прим.перев: настоятельно советую для НЕрелизных сборок компилятора и Лазаруса использовать [[fpcupdeluxe/ru\|fpcupdeluxe]]
135	135
136	136		### Lazarus Fixes 2.2
137	137
138	138		- [[Lazarus 2.2 fixes branch\|Fixes included in fixes_2_2]]
139	139
140	140		Есть ряд причин, по которым вам может быть лучше использовать нерелизную версию Lazarus, в частности, fixes_2_2. Особенно:
141	141
142	142		- Вам почти наверняка нужно ориентироваться на 64-битный Cocoa, macOS 10.15 Catalina и более поздние версии вообще не поддерживают 32-битный Carbon.
143	143		- Набор виджетов Cocoa постоянно улучшался, а интерфейс отладчика lldb быстро улучшался, начиная с версии 2.0.0.
144	144		- Если на вашем Mac установлен процессор Apple M1, отладчик в fixes_2_2 теперь работает для aarch64.
145	145		- Fixes_2_2 — более безопасный и стабильный вариант, чем ветка разработки, но все равно получает новые функции намного быстрее, чем релизная версия.
146	146
147	147		Предварительно скомпилированные двоичные файлы на основе fixes_2_2 недоступны в SourceForge, поэтому мы загружаем и собираем их из исходного кода. Сначала немного медленный, но очень надежный и отличный тест установки вашего компилятора! Вам понадобится git, который включен во все последние версии инструментов командной строки Xcode, которые вы уже должны были установить (см. [[Installing Lazarus on macOS/ru\|Инструменты командной строки Xcode]] выше).
148	148
149	149		Касательно svn или git: инструменты командной строки Xcode 11.4 в macOS 10.15 больше не устанавливают svn, только git. Вы можете установить Subversion через fink, порты или brew.
150	150
151	151		Additional notes for building a native aarch64 Lazarus IDE for an Apple Silicon M1 processor Mac
152	152
153	153		Убедитесь, что вы скомпилировали собственный компилятор Free Pascal aarch64 (как это сделать, см. в разделе Поддержка Apple Silicon).
154	154
155	155		> Note: Выпуск FPC 3.2.2 включает в себя универсальные двоичные файлы, которые изначально будут работать как на aarch64 (64-разрядная версия ARM — Apple Silicon M1), так и на x86_64 (64-разрядная версия Intel), поэтому вам больше не нужно компилировать свои собственные из исходного кода.
156	156
157	157		При сборке Lazarus IDE измените CPU_TARGET в приведенных ниже инструкциях с x86_64 (64-разрядная версия Intel) на aarch64 (64-разрядная версия ARM — Apple Silicon M1).
158	158
159	159		#### Загрузка исходного кода Lazarus Fixes 2.2
160	160
161	161		Создайте каталог для Lazarus и загрузите текущую версию исправлений:
162	162
163	163		``` bash
164	164		cd
165	165		mkdir -p bin/lazarus
166	166		cd bin/lazarus
167	167		```
168	168
169	169		С использованием git:
170	170
171		-	~~`git clone -b fixes_2_2 `[`https://gitlab.com/freepascal.org/lazarus/lazarus.git`](https://gitlab.com/freepascal.org/lazarus/lazarus.git)` laz_fixes`~~
	171	+	```text
	172	+	git clone -b fixes_2_2 https://gitlab.com/freepascal.org/lazarus/lazarus.git laz_fixes
	173	+	```
172	174
173	175		С использованием svn:
174	176
175		-	~~`svn checkout `[`https://github.com/fpc/Lazarus/branches/fixes_2_2`](https://github.com/fpc/Lazarus/branches/fixes_2_2)` laz_fixes`~~
	177	+	```text
	178	+	svn checkout https://github.com/fpc/Lazarus/branches/fixes_2_2 laz_fixes
	179	+	```
176	180
177	181		В зависимости от вашего интернет-соединения и загруженности сервера это может занять от нескольких секунд до нескольких минут.
178	182
179	183		#### Обновление исходного кода Lazarus Fixes 2.2
180	184
181	185		Чтобы поддерживать установку fixes_2_2 в актуальном состоянии, достаточно просто:
182	186
183	187		С использованием git:
184	188
185	189		``` bash
186	190		cd ~/bin/lazarus/laz_fixes
187	191		git clean -f -d
188	192		git pull
189	193		```
190	194
191	195		С использованием svn:
192	196
193	197		``` bash
194	198		cd ~/bin/lazarus/laz_fixes
195	199		svn clean --remove-unversioned
196	200		svn update
197	201		```
198	202
199	203		#### Сборка исходного кода Lazarus Fixes 2.2
200	204
201	205		``` bash
202	206		cd laz_fixes
203	207		make distclean all LCL_PLATFORM=cocoa CPU_TARGET=x86_64 bigide
204	208		//-wait some time...
205	209		open startlazarus.app --args "--pcp=~/.laz_fixes"
206	210		```
207	211
208	212		- Примечание. Я передаю параметр для использования каталога конфигурации, основанного на имени фактического каталога установки. Это упрощает написание некоторых сценариев.
209	213
210	214		- В более старых версиях macOS, поддерживающих 32-битные приложения, замените приведенную выше строку make на "make LCL_PLATFORM=carbon CPU_TARGET=i386 bigide " и настройте свой проект, как указано в разделе [[Installing Lazarus on macOS/ru\|Carbon в сравнении с Cocoa]] выше.
211	215
212	216		Возможно, вы захотите поместить небольшой скрипт в каталог \$HOME/bin и даже указать путь к нему (очень UNIX!)
213	217
214	218		``` bash
215	219		#!/bin/bash
216	220		LAZDIR="laz_fixes"
217	221		cd ~/bin/lazarus/"$LAZDIR"
218	222		open ~/bin/lazarus/"$LAZDIR"/lazarus.app --args "--pcp=~/.$LAZDIR"
219	223		```
220	224
221	225		### Разрабатываемая версия Лазаруса
222	226
223	227		- [[Lazarus 2.4.0 release notes\|Примечания к разрабатываемой версии Lazarus]] - Примечание: работа в процессе
224	228
225	229		Предварительно скомпилированные двоичные файлы, основанные на версии для разработки (известной как "trunk" в SVN; теперь известна как "main" в GIT) среды разработки Lazarus недоступны в SourceForge, поэтому можно загрузить исходный код версии для разработки с помощью svn или git и собрать IDE Lazarus. Вам понадобится svn (до macOS 10.15 — Catalina) или git (после macOS 10.14 — Mojave), который включен в автономные инструменты командной строки Xcode, которые вы уже должны были установить (см. Инструменты командной строки Xcode выше).
226	230
227	231		#### Скачивание исходного кода разрабатываемой версии Lazarus
228	232
229	233		``` sh
230	234		cd
231	235		mkdir -p bin/lazarus
232	236		cd bin/lazarus
233	237		```
234	238
235	239		С использованием git:
236	240
237		-	~~`git clone -b main `[`https://gitlab.com/freepascal.org/lazarus/lazarus.git`](https://gitlab.com/freepascal.org/lazarus/lazarus.git)` laz_main`~~
	241	+	```text
	242	+	git clone -b main https://gitlab.com/freepascal.org/lazarus/lazarus.git laz_main
	243	+	```
238	244
239	245		С использованием svn:
240	246
241		-	~~`svn checkout --depth files `[`https://github.com/fpc/Lazarus/branches`](https://github.com/fpc/Lazarus/branches)` all`\~~
242		-	~~`cd all`\~~
243		-	~~`svn update --set-depth infinity main`~~
	247	+	```text
	248	+	svn checkout --depth files https://github.com/fpc/Lazarus/branches all
	249	+	cd all
	250	+	svn update --set-depth infinity main
	251	+	```
244	252
245	253		Приведенный выше вызов svn более сложен из-за бага во многих версиях Subversion. В качестве обходного пути рекомендуется использование утилиты Альфреда (он же Don Alfredo на [[Forum\|форуме]]), который является создателем [[fpcupdeluxe/ru\|fpcupdeluxe]].
246	254
247	255		#### Обновление исходников версии Lazarus для разработки
248	256
249	257		Чтобы обновить существующий исходный код версии Lazarus для разработки, следует сделать следующее:
250	258
251	259		С использованием git:
252	260
253	261		``` bash
254	262		cd ~/bin/lazarus/laz_main
255	263		git clean -f -d
256	264		git pull
257	265		```
258	266
259	267		С использованием svn:
260	268
261	269		``` bash
262	270		cd ~/bin/lazarus/laz_trunk
263	271		svn cleanup --remove-unversioned
264	272		svn update
265	273		```
266	274
267	275		#### Сборка исходного кода версии Lazarus для разработки
268	276
269	277		``` bash
270	278		make distclean all LCL_PLATFORM=cocoa CPU_TARGET=x86_64 bigide
271	279		//-wait some time...
272	280		open startlazarus.app --args "--pcp=~/.laz_dev"
273	281		```
274	282
275	283		### Что делает аргумент make bigide?
276	284
277	285		Аргумент bigide `make` добавляет в Lazarus кучу пакетов, которые многие находят полезными и без которых не могут обойтись. Пакеты, которые добавляются:
278	286
279	287		- cairocanvas
280	288		- chmhelp
281	289		- datetimectrls
282	290		- externhelp
283	291		- fpcunit
284	292		- fpdebug
285	293		- instantfpc
286	294		- jcf2
287	295		- lazcontrols
288	296		- lazdebuggers
289	297
290	298		- lclextensions
291	299		- leakview
292	300		- macroscript
293	301		- memds
294	302		- onlinepackagemanager
295	303		- pas2js
296	304		- PascalScript
297	305		- printers
298	306		- projecttemplates
299	307		- rtticontrols
300	308
301	309		- sdf
302	310		- sqldb
303	311		- synedit
304	312		- tachart
305	313		- tdbf
306	314		- todolist
307	315		- turbopower_ipro
308	316		- virtualtreeview
309	317
310	318		Приведенный выше список взят из `[Lazarus source directory]/IDE/Makefile.fpc` и может быть изменен.
311	319
312	320		Обратите внимание: если вы не скомпилировали свою собственную Lazarus IDE с аргументом bigide, вы можете установить любой из этих пакетов самостоятельно, используя диалоговое окно Lazarus IDE [[IDE Window: Installed Packages\|Package > Install/Uninstall Packages...]]
313	321
314	322		## Установка незарелизенных версий FPC
315	323
316	324		### Установка из исходников
317	325
318	326		В настоящее время существует две незарелизенные ветки компилятора Free Pascal: ветка разработки (trunk) и ветка Fixes 3.2, которая включает дополнительные исправления выпущенной версии 3.2.2. Разработчики и те, кто любит находиться на переднем крае и тестировать новые функции и исправления, выберут версию для разработчиков; а обычные пользователи, которые хотят использовать стабильную ветку с некоторыми дополнительными исправлениями, начиная с последней версии выпуска, выберут ветку Fixes. Приведенные ниже инструкции охватывают обе эти ветви.
319	327
320	328		Исходный код хранится в системе контроля версий под названием git:
321	329
322	330		- macOS 10.5 и выше уже содержат git-клиент командной строки, если вы установили утилиты командной строки Xcode.
323	331
324	332		- Вам также необходимо установить последнюю релизную версию компилятора Free Pascal (3.2.2 по состоянию на март 2022 г.), чтобы иметь возможность успешно скомпилировать разрабатываемую (trunk) версию.
325	333
326	334		> Note: При сборке нативного компилятора Free Pascal под aarch64 (ppca64) для процессора Apple Silicon M1 Mac измените CPU_TARGET в приведенных ниже инструкциях с x86_64 (64-разрядная версия Intel) на aarch64 (64-разрядная версия ARM — Apple Silicon M1) и измените любую ссылку с ppcx64 на ppca64
327	335
328	336		#### FPC веросия для разработчиков
329	337
330	338		- [[FPC New Features Trunk\|Новые функции FPC trunk]]
331	339		- [[User Changes Trunk\|Изменения для ползователей FPC trunk]] - может сломать существующий код.
332	340
333	341		Обратите внимание, что поскольку версия FPC для разработки (известная как "trunk" в SVN; теперь известная как `main` в GIT) по определению все еще находится в стадии разработки, некоторые функции могут измениться до того, как они попадут в релизную версию.
334	342
335	343		Создайте каталог, в который вы хотите поместить исходный код (например, fpc_main в вашем домашнем каталоге). Вам не нужно быть root, чтобы сделать это. Это может сделать любой нормальный пользователь. Откройте Applications \> Utilities \> Terminal и выполните следующие действия:
336	344
337	345		``` sh
338	346		[]$ git clone -b main https://gitlab.com/freepascal.org/fpc/source.git fpc_main
339	347		```
340	348
341	349		Это создаст каталог с именем `fpc_main` и загрузит в него основной исходный код FPC.
342	350
343	351		Чтобы впоследствии обновить локальный репозиторий исходного кода последними изменениями исходного кода, вы можете просто сделать:
344	352
345	353		``` sh
346	354		[]$ cd
347	355		[]$ cd fpc_main
348	356		[]$ git clean -f -d
349	357		[]$ git pull
350	358		```
351	359
352	360		Чтобы собрать и установить FPC (выделенный текст должен быть на одной строке):
353	361
354	362		``` sh
355	363		[]$ cd
356	364		[]$ cd fpc_main
357	365		[]$ make distclean all FPC=/usr/local/lib/fpc/3.2.2/ppcx64 OS_TARGET=darwin CPU_TARGET=x86_64 OPT="-XR/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/"
358	366		[]$ sudo make install FPC=$PWD/compiler/ppcx64 OS_TARGET=darwin CPU_TARGET=x86_64
359	367		```
360	368
361	369		Вам также потребуется обновить ссылки для компилятора в `/usr/local/bin`, которые будут указывать на предыдущую версию FPC. Например:
362	370
363	371		``` sh
364	372		[]$ cd /usr/local/bin
365	373		[]$ sudo rm ppc386
366	374		[]$ sudo rm ppcx64
367	375		[]$ sudo ln -s /usr/local/lib/fpc/3.3.1/ppc386
368	376		[]$ sudo ln -s /usr/local/lib/fpc/3.3.1/ppcx64
369	377		```
370	378
371	379		Обратите внимание, что вам потребуется создать новый `ppc386` компилятор, если вы хотите продолжить компилировать 32-битные приложения, заменив эти строки (это невозможно после Xcode 11.3.1 и macOS 10.14.6 Mojave из-за удаления Apple'ом 32-битных фреймворков):
372	380
373	381		``` sh
374	382		[]$ make clean all FPC=/usr/local/lib/fpc/3.2.2/ppcx64 OS_TARGET=darwin CPU_TARGET=x86_64 OPT="-XR/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/"
375	383		[]$ sudo make install FPC=$PWD/compiler/ppcx64 OS_TARGET=darwin CPU_TARGET=x86_64
376	384		```
377	385
378	386		с этими двумя строками:
379	387
380	388		``` sh
381	389		[]$ make clean all FPC=/usr/local/lib/fpc/3.2.2/ppc386 OS_TARGET=darwin CPU_TARGET=i386 OPT="-XR/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/"
382	390		[]$ sudo make install FPC=$PWD/compiler/ppc386 OS_TARGET=darwin CPU_TARGET=i386
383	391		```
384	392
385	393		#### FPC Fixes 3.2
386	394
387	395		Создайте каталог, в который вы хотите поместить исходный код (например, `fpc_fixes32` в вашем домашнем каталоге). Вам не нужно быть root, чтобы сделать это. Это может сделать любой нормальный пользователь. Откройте Applications \> Utilities \> Terminal и выполните следующие действия:
388	396
389	397		``` sh
390	398		[]$ git clone -b fixes_3_2 https://gitlab.com/freepascal.org/fpc/source.git fpc_fixes32
391	399		```
392	400
393	401		Это создаст каталог с именем `fpc_fixes32` и загрузит в него исходный код FPC.
394	402
395	403		Чтобы впоследствии обновить локальную копию исходного кода репозитория последними изменениями исходного кода, вы можете просто сделать:
396	404
397	405		``` sh
398	406		[]$ cd fpc_fixes32
399	407		[]$ git clean -f -d
400	408		[]$ git pull
401	409		```
402	410
403	411		Чтобы собрать и установить FPC (выделенный текст должен быть на одной строке):
404	412
405	413		``` sh
406	414		[]$ cd
407	415		[]$ cd fpc_fixes32
408	416		[]$ make distclean all FPC=/usr/local/lib/fpc/3.2.2/ppcx64 OS_TARGET=darwin CPU_TARGET=x86_64 OPT="-XR/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/"
409	417		[]$ sudo make install FPC=$PWD/compiler/ppcx64 OS_TARGET=darwin CPU_TARGET=x86_64
410	418		```
411	419
412	420		Вам также потребуется обновить ссылки для компилятора в `/usr/local/bin`, которые будут указывать на предыдущую версию FPC. Например:
413	421
414	422		``` sh
415	423		[]$ cd /usr/local/bin
416	424		[]$ sudo rm ppc386
417	425		[]$ sudo rm ppcx64
418	426		[]$ sudo ln -s /usr/local/lib/fpc/fixes-3.2/ppc386
419	427		[]$ sudo ln -s /usr/local/lib/fpc/fixes-3.2/ppcx64
420	428		```
421	429
422	430		Обратите внимание, что вам потребуется создать новый `ppc386` компилятор, если вы хотите продолжить компилировать 32-битные приложения, заменив эти строки (это невозможно после Xcode 11.3.1 и macOS 10.14.6 Mojave из-за удаления Apple'ом 32-битных фреймворков):
423	431
424	432		``` sh
425	433		[]$ make clean all FPC=/usr/local/lib/fpc/3.2.2/ppc386 OS_TARGET=darwin CPU_TARGET=i386 OPT="-XR/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/"
426	434		[]$ sudo make install FPC=$PWD/compiler/ppc386 OS_TARGET=darwin CPU_TARGET=i386
427	435		```
428	436
429	437		## Известные проблемы и решения
430	438
431	439		### Lazarus IDE v2.2.0 - проблема пересборки
432	440
433	441		Любая попытка пересобрать IDE Lazarus из самой себя завершается ошибкой с правами доступа, поскольку файлы и каталоги принадлежат пользователю с идентификатором 503, в то время как большинство пользователей обнаружат, что их идентификатор равен 501. Решение состоит в том, чтобы открыть Applications \> Utilities\> Terminal и:
434	442
435		-	~~`cd /Applications`\~~
436		-	~~`sudo chown -R your_username Lazarus`~~
	443	+	```text
	444	+	cd /Applications
	445	+	sudo chown -R your_username Lazarus
	446	+	```
437	447
438	448		#### Следующие ошибки пересборки не возникают на компьютерах Intel
439	449
440	450		Следующая ошибка заключается в том, что компилятор ресурсов «fpcres» может быть не найден. Решение состоит в том, чтобы создать файл `.fpc.cfg` (обратите внимание на начальную точку) в вашем домашнем каталоге и добавить в него следующие строки:
441	451
442		-	~~`#include /etc/fpc.cfg`\~~
443		-	~~`-FD/usr/local/bin`~~
	452	+	```text
	453	+	#include /etc/fpc.cfg
	454	+	-FD/usr/local/bin
	455	+	```
444	456
445	457		чтобы "fpcres" можно было найти там, где он был установлен.
446	458
447	459		Следующая ошибка указывает на неподдерживаемую целевую архитектуру `-Paarch64` с советом вместо этого вызвать драйвер компилятора "fpc", не взирая на то, что мы уже делаем. Решение состоит в том, чтобы перейти в Lazarus \> Preferences \> Compiler к исполняемому файлу компилятора, для которого установлено значение `/usr/local/bin/fpc`, и изменить его на `/usr/local/lib/fpc/3.2.2/ppca64`.
448	460
449	461		Теперь среда IDE будет успешно пересобрана, но не перезапустится автоматически. Попытка затем запустить Lazarus с помощью значка`startlazarus.app` или значка `lazarus.app` в `/Applications/Lazarus` по-прежнему будет приводить к запуску исходного двоичного файла Intel lazarus. Правильный бинарный файл aarch64 можно найти в `~/.lazarus/bin/aarch64-darwin/lazarus`. Таким образом, окончательное решение — открыть Application \> Utilities \> Terminal и:
450	462
451		-	~~`mv /Applications/Lazarus/lazarus /Applications/Lazarus/lazarus.old`\~~
452		-	~~`mv ~/.lazarus/bin/aarch64-darwin/lazarus /Applications/Lazarus/`~~
	463	+	```text
	464	+	mv /Applications/Lazarus/lazarus /Applications/Lazarus/lazarus.old
	465	+	mv ~/.lazarus/bin/aarch64-darwin/lazarus /Applications/Lazarus/
	466	+	```
453	467
454	468		Затем вы можете запустить IDE с помощью значков `startLazarus.app` или `lazarus.app`. Когда вы перезапустите lazarus, стоит вернуться в Lazarus \> Preferences \> Compiler к исполняемому файлу компилятора, для которого установлено значение `/usr/local/lib/fpc/3.2.2/ppca64`, и изменить его обратно на `/usr/local/bin/fpc`, чтобы вы могли скомпилировать двоичные файлы как для aarch64, так и для Intel, чтобы, например, создать [[macOS Big Sur changes for developers\|Universal Binary]], который будет работать как на машинах Intel, так и на машинах aarch64.
455	469
456	470		### Lazarus IDE - Unable to "run without debugging"
457	471
458	472		Если вы используете Lazarus IDE 2.0.10 и пункт меню «Выполнить \> Запустить без отладки» не работает с диалоговым окном, подобным:
459	473
460	474		![](/wiki-images/3/32/Run_dialog_fail.png)
461	475
462	476		затем вам необходимо исправить исходный код Lazarus 2.0.10 ([Issue \#37324](https://bugs.freepascal.org/view.php?id=37324) и [Issue \#36780](https://bugs.freepascal.org/view.php?id=36780)). В частности, исправьте `../ide/main.pp`, как показано ниже (неисправленные строки показаны первыми, исправленные строки показаны вторыми):
463	477
464		-	~~` 7243,7245c7243,7245`\~~
465		-	~~` < if RunAppBundle`\~~
466		-	~~` < and FileExistsUTF8(Process.Executable)`\~~
467		-	~~` < and FileExistsUTF8('/usr/bin/open') then`\~~
468		-	~~` ---`\~~
469		-	~~` > if RunAppBundle then`\~~
470		-	~~` > // and FileExistsUTF8(Process.Executable)`\~~
471		-	~~` > //and FileExistsUTF8('/usr/bin/open') then`~~
	478	+	```text
	479	+	7243,7245c7243,7245
	480	+	< if RunAppBundle
	481	+	< and FileExistsUTF8(Process.Executable)
	482	+	< and FileExistsUTF8('/usr/bin/open') then
	483	+	---
	484	+	> if RunAppBundle then
	485	+	> // and FileExistsUTF8(Process.Executable)
	486	+	> //and FileExistsUTF8('/usr/bin/open') then
	487	+	```
472	488
473	489		и перекомпилируйте Lazarus IDE.
474	490
475	491		Кроме того, вы можете не исправлять исходный код и просто перекомпилировать Lazarus 2.0.10 с FPC 3.0.4.
476	492
477	493		Аналогичные действия по исправлению и перекомпиляции или просто перекомпиляции с FPC 3.0.4 необходимо выполнить для Lazarus 2.0.8, если он был скомпилирован с FPC 3.2.0.
478	494
479	495		### Обновление с Mojave (10.14) до Catalina (10.15)
480	496
481	497		- Выполните `sudo xcode-select --install`
482	498
483	499		- Чтобы Lazarus мог найти файл `crt1.10.5.o`, измените в `/etc/fpc.cfg` -Fl после '#ifdef cpux86_64' с
484	500
485		-	~~`-Fl/Applications/Xcode.app/Contents/Developer/Toolchain...`~~
	501	+	```text
	502	+	-Fl/Applications/Xcode.app/Contents/Developer/Toolchain...
	503	+	```
486	504
487	505		на
488	506
489		-	~~`-Fl/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/lib/`~~
	507	+	```text
	508	+	-Fl/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/lib/
	509	+	```
490	510
491	511		### Сборка компилятора FPC, начиная с Mojave (10.14) и далее
492	512
493	513		- Чтобы найти файл crt1.10.5.o при сборке более поздней версии Free Pascal Compiler из исходного кода, необходимо указать:
494	514
495		-	~~` OPT="-XR/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/"`~~
	515	+	```text
	516	+	OPT="-XR/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/"
	517	+	```
496	518
497	519		в командной строке make, потому что FPC игнорирует файл конфигурации `/etc/fpc.cfg` во время сборки.
498	520
499	521		### ЧаВо по установке на Mac
500	522
501	523		- См. [[Mac Installation FAQ]], чтобы узнать о решениях других распространенных проблем, которые могут возникнуть во время (и после) установки Lazarus и Free Pascal на macOS.
502	524
503	525		## Деинсталляция Lazarus и Free Pascal
504	526
505	527		Обратитесь к [[Uninstalling Lazarus on macOS\|Удаление Lazarus в macOS]] для получения информации о вариантах удаления.
506	528
507	529		## Устаревшая информация
508	530
509	531		See [[Legacy Information: Installing Lazarus on Mac\|Legacy Information]] for details of:
510	532
511	533		- Installing Lazarus on Mac OS X 10.4 (Tiger), Mac OS X 10.5 (Leopard), OS X 10.8 (Mountain Lion)
512	534		- Installing Lazarus 2.0.8, 2.0.10 with FPC 3.2.0 for macOS 10.10 and earlier
513	535		- Installing Lazarus 2.0.8 with FPC 3.2.0 for macOS 10.11+
514	536		- Installing Lazarus on PowerPC-based Macs
515	537		- Old Xcode versions
516	538		- Installing the gdb debugger
517	539		- Compatibility matrix for Lazarus 1.0.0 through 1.6.4 and FPC 2.6.0 through 3.0.2.
518	540
519	541		# См. также
520	542
521	543		- [[Xcode]].
522	544		- [[Other macOS installation options]].
523	545		- [[Multiple Lazarus\|Installing multiple Lazarus versions]].
524	546		- [[Portal:Mac\|Mac Portal]] for an overview of development for macOS with Lazarus and Free Pascal.
525	547		- [[Mac Installation FAQ]] for solutions to the most frequent problems that may arise during (and after) installation of Lazarus and Free Pascal on macOS.
526	548
527	549		# Внешние ссылки
528	550
529	551		- [Lazarus daily development version download](https://sourceforge.net/projects/macos-lazarus-snapshots/files/intel/) (Intel x86_64)
530	552		- [Lazarus + FPC daily development version downloads](https://sourceforge.net/projects/macos-lazarus-snapshots/files/arm64/) (M1, ARM64, aarch64)
531	553		- [GIT Succinctly](https://www.syncfusion.com/succinctly-free-ebooks/git) - Free Ebook (PDF, MOBI, EPUB) from SyncFusion.
532	554		- [Uninstall Xcode Command Line Tools](https://mac.install.guide/commandlinetools/6.html)
533	555		- [Reinstall Xcode Command Line Tools](https://mac.install.guide/commandlinetools/7.html)
534	556
535	557		---
536	558		From the Free Pascal wiki, page "Installing Lazarus on macOS/ru", as it stood on 2022-07-26 after a change by Zoltanleo, 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).

Back to history