Application Bundle/ru: what changed

Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.

Title: Application Bundle/ru

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