Application Bundle/ru: what changed

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

Old	New		Line
1	1		## Обзор
2	2
3	3		Пакет приложений - это каталог с расширением «.app» в системах macOS. Он содержит исполняемый файл приложения, файлы ресурсов, файлы библиотеки (если есть), файлы справки и информацию о приложении и необходим для правильного выполнения приложений. Mac Finder рассматривает этот каталог .app как файл приложения и по умолчанию не отображает ни один из его подкаталогов.
4	4
5	5		Изнутри Lazarus он используется для интерфейсов [[Carbon Interface\|Carbon]] и [[Cocoa Interface\|Cocoa]], но можно также создавать приложения с другими интерфейсами (например, Gtk или QAt) с помощью скриптов.
6	6
7	7		Вы можете узнать больше о пакетах приложений в Apple [Bundle Programming Guide](https://developer.apple.com/library/archive/documentation/CoreFoundation/Conceptual/CFBundles/BundleTypes/BundleTypes.html#//apple_ref/doc/uid/10000123i-CH101-SW19).
8	8
9	9		Настройки приложения (пакета) находятся в файле списка свойств: [[macOS property list files\|Info.plist]] , расположенном в каталоге bundle.app/Contents/.
10	10
11	11		Чтобы получить доступ к набору приложений, вам нужно щелкнуть правой кнопкой мыши (ctrl-левой кнопкой мыши) на пакете и выбрать Show Package Contents(Показать содержимое пакета).
12	12
13	13		![](/wiki-images/1/12/Openbundle.png)
14	14
15	15		![](/wiki-images/8/81/Infoplist.png)
16	16
17	17		## Макет пакета приложения
18	18
19	19		Базовая структура пакета приложений Mac:
20	20
21		-	~~`MyApp.app/`\~~
22		-	~~` Contents/`\~~
23		-	~~` Info.plist`\~~
24		-	~~` MacOS/`\~~
25		-	~~` Resources/`~~
	21	+	```
	22	+	MyApp.app/
	23	+	Contents/
	24	+	Info.plist
	25	+	MacOS/
	26	+	Resources/
	27	+	```
26	28
27	29		\| Подпапка каталога Contents \| Описание использования \|
28	30		\|----\|----\|
29	31		\| MacOS \| (Обязательный) Содержит автономный исполняемый код приложения. Обычно этот каталог содержит только один двоичный файл с основной точкой входа вашего приложения и статически связанным кодом. Однако вы можете поместить в этот каталог и другие автономные исполняемые файлы (например, инструменты командной строки). \|
30	32		\| Resources \| Содержит все файлы ресурсов приложения. Содержимое этого каталога дополнительно организовано, чтобы различать локализованные и нелокализованные ресурсы. Для получения дополнительных сведений о структуре этого каталога см. [[Add an Apple Help Book to your macOS app\|Adding a Help Book - Bundle layouts]]. \|
31	33		\| Frameworks \| Содержит все частные разделяемые библиотеки и фреймворки, используемые исполняемым файлом. Платформы в этом каталоге привязаны к редакциям приложения и не могут быть заменены никакими другими, даже более новыми версиями, которые могут быть доступны для операционной системы. Другими словами, фреймворки, включенные в этот каталог, имеют приоритет над любыми другими фреймворками с аналогичными названиями в других частях операционной системы. Для получения информации о том, как добавить общие библиотеки в пакет приложений, см. [[macOS Dynamic Libraries]]. \|
32	34		\| PlugIns \| Содержит загружаемые пакеты, расширяющие базовые функции вашего приложения. Вы используете этот каталог для включения модулей кода, которые должны быть загружены в пространство процесса вашего приложения для использования. Вы не должны использовать этот каталог для хранения автономных исполняемых файлов. \|
33	35		\| SharedSupport \| Содержит дополнительные некритические ресурсы, которые не влияют на возможность запуска приложения. Вы можете использовать этот каталог для включения таких вещей, как шаблоны документов, картинки и учебные пособия, наличие которых может ожидать ваше приложение, но которые не влияют на способность вашего приложения работать. \|
34	36
35	37		## Создание пакета приложения
36	38
37	39		### Посредством Lazarus
38	40
39	41		Откройте проект и перейдите в Project -\> Project Options -\> вкладку Application, и нажмите кнопку [[IDE Window: Project Options/ru\|Create Application Bundle]]. Полученный пакет приложений будет содержать символическую ссылку на реальный исполняемый файл.
40	42
41	43		> Note: Вы должны удалить символическую ссылку и скопировать реальный исполняемый файл "project1" в каталог project1.app/Contents/MacOS/, если хотите распространять приложение и использовать его на другом компьютере.
42	44
43	45		### Посредством инструмента командной строки, поставляемым с Lazarus
44	46
45	47		Откройте /Library/Lazarus/components/macfiles/examples/createmacapplication.lpi в IDE. Скомпилируйте.
46	48
47	49		Откройте терминал по вашему выбору и введите:
48	50
49	51		``` bash
50	52		cd project1/
51	53		/Library/Lazarus/components/macfiles/examples/createmacapplication project1
52	54		ln -s ../../../project1 project1.app/Contents/MacOS/project1
53	55		```
54	56
55	57		### Посредством сценария оболочки
56	58
57	59		You can adapt the following shell script to create a customized application bundle for your application. It allows the creation of either debug or release bundle.
58	60
59	61		- In the debug bundle, a link to the executable is placed, allowing for debugging using the Lazarus IDE,
60	62		- In the release bundle, the executable is copied so the application bundle as a whole can be used stand-alone/copied to other locations.
61	63
62	64		Вы можете адаптировать следующий сценарий оболочки для создания настраиваемого пакета приложений для вашего приложения. Это позволяет создавать пакеты debug или release.
63	65
64	66		- В пакете debug размещена ссылка на исполняемый файл, что позволяет делать отладку с использованием Lazarus IDE,
65	67		- В пакете release исполняемый файл копируется, поэтому комплект приложения в целом можно использовать отдельно/скопировать в другие места.
66	68
67	69		``` bash
68	70		#!/bin/sh
69	71		# Force Bourne shell in case tcsh is default.
70	72		#
71	73
72	74		#
73	75		# Reads the bundle type
74	76		#
75	77
76	78		echo "========================================================"
77	79		echo " Bundle creation script"
78	80		echo "========================================================"
79	81		echo ""
80	82		echo " Please select which kind of bundle you would like to build:"
81	83		echo ""
82	84		echo " 1 > Debug bundle"
83	85		echo " 2 > Release bundle"
84	86		echo " 0 > Exit"
85	87
86	88		read command
87	89
88	90		case $command in
89	91
90	92		1) ;;
91	93
92	94		2) ;;
93	95
94	96		0) exit 0;;
95	97
96	98		*) echo "Invalid command"
97	99		exit 0;;
98	100
99	101		esac
100	102
101	103		#
102	104		# Creates the bundle
103	105		#
104	106
105	107		appname=Magnifier
106	108		appfolder=$appname.app
107	109		macosfolder=$appfolder/Contents/MacOS
108	110		plistfile=$appfolder/Contents/Info.plist
109	111		appfile=magnifier
110	112
111	113		PkgInfoContents="APPLMAG#"
112	114
113	115		#
114	116		if ! [ -e $appfile ]
115	117		then
116	118		echo "$appfile does not exist"
117	119		elif [ -e $appfolder ]
118	120		then
119	121		echo "$appfolder already exists"
120	122		else
121	123		echo "Creating $appfolder..."
122	124		mkdir $appfolder
123	125		mkdir $appfolder/Contents
124	126		mkdir $appfolder/Contents/MacOS
125	127		mkdir $appfolder/Contents/Frameworks # optional, for including libraries or frameworks
126	128		mkdir $appfolder/Contents/Resources
127	129
128	130		#
129	131		# For a debug bundle,
130	132		# Instead of copying executable into .app folder after each compile,
131	133		# simply create a symbolic link to executable.
132	134		#
133	135		if [ $command = 1 ]; then
134	136		ln -s ../../../$appname $macosfolder/$appname
135	137		else
136	138		cp $appname $macosfolder/$appname
137	139		fi
138	140
139	141		# Copy the resource files to the correct place
140	142		cp *.bmp $appfolder/Contents/Resources
141	143		cp icon3.ico $appfolder/Contents/Resources
142	144		cp icon3.png $appfolder/Contents/Resources
143	145		cp macicon.icns $appfolder/Contents/Resources
144	146		cp docs/. $appfolder/Contents/Resources
145	147		#
146	148		# Create PkgInfo file.
147	149		echo $PkgInfoContents >$appfolder/Contents/PkgInfo
148	150		#
149	151		# Create information property list file (Info.plist).
150	152		echo '<?xml version="1.0" encoding="UTF-8"?>' >$plistfile
151	153		echo '<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">' >>$plistfile
152	154		echo '<plist version="1.0">' >>$plistfile
153	155		echo '<dict>' >>$plistfile
154	156		echo ' <key>CFBundleDevelopmentRegion</key>' >>$plistfile
155	157		echo ' <string>English</string>' >>$plistfile
156	158		echo ' <key>CFBundleExecutable</key>' >>$plistfile
157	159		echo ' <string>'$appname'</string>' >>$plistfile
158	160		echo ' <key>CFBundleIconFile</key>' >>$plistfile
159	161		echo ' <string>macicon.icns</string>' >>$plistfile
160	162		echo ' <key>CFBundleIdentifier</key>' >>$plistfile
161	163		echo ' <string>org.magnifier.magnifier</string>' >>$plistfile
162	164		echo ' <key>CFBundleInfoDictionaryVersion</key>' >>$plistfile
163	165		echo ' <string>6.0</string>' >>$plistfile
164	166		echo ' <key>CFBundlePackageType</key>' >>$plistfile
165	167		echo ' <string>APPL</string>' >>$plistfile
166	168		echo ' <key>CFBundleSignature</key>' >>$plistfile
167	169		echo ' <string>MAG#</string>' >>$plistfile
168	170		echo ' <key>CFBundleVersion</key>' >>$plistfile
169	171		echo ' <string>1.0</string>' >>$plistfile
170	172		echo '</dict>' >>$plistfile
171	173		echo '</plist>' >>$plistfile
172	174		fi
173	175		```
174	176
175	177		## Запуск приложения через Application Bundle
176	178
177	179		Вы можете запустить приложение из среды IDE с помощью значка Finder или в собственном MacOS-овском Terminal.app посредством "open project1.app".
178	180
179	181		## См.также
180	182
181	183		- [[macOS property list files]]
182	184		- [[Add an Apple Help Book to your macOS app]]
183	185		- [[Hiding a macOS app from the Dock]]
184	186
185	187		## Внешние ссылки
186	188
187	189		- [Apple: NSBundle class](https://developer.apple.com/documentation/foundation/nsbundle)
188	190		- [Apple: Bundle Resources](https://developer.apple.com/documentation/bundleresources/)
189	191		- [Apple: CFBundle](https://developer.apple.com/documentation/corefoundation/cfbundle)
190	192		- [Apple: Bundle Configuration](https://developer.apple.com/documentation/bundleresources/information_property_list/bundle_configuration)
191	193		- [Apple: Resource Programming Guide](https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/LoadingResources/Introduction/Introduction.html)
192	194		- [Apple: Bundle Programming Guide](https://developer.apple.com/library/archive/documentation/CoreFoundation/Conceptual/CFBundles/Introduction/Introduction.html)
193	195
194	196		---
195	197		From the Free Pascal wiki, page "Application Bundle/ru", as it stood on 2020-08-18 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