Sign in Join
Wiki copytemporary

Application Bundle/ru: what changed

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

OldNewLine
11## Обзор
22
33Пакет приложений - это каталог с расширением «.app» в системах macOS. Он содержит исполняемый файл приложения, файлы ресурсов, файлы библиотеки (если есть), файлы справки и информацию о приложении и необходим для правильного выполнения приложений. Mac Finder рассматривает этот каталог .app как файл приложения и по умолчанию не отображает ни один из его подкаталогов.
44
55Изнутри Lazarus он используется для интерфейсов [[Carbon Interface|Carbon]] и [[Cocoa Interface|Cocoa]], но можно также создавать приложения с другими интерфейсами (например, Gtk или QAt) с помощью скриптов.
66
77Вы можете узнать больше о пакетах приложений в Apple [Bundle Programming Guide](https://developer.apple.com/library/archive/documentation/CoreFoundation/Conceptual/CFBundles/BundleTypes/BundleTypes.html#//apple_ref/doc/uid/10000123i-CH101-SW19).
88
99Настройки приложения (пакета) находятся в файле списка свойств: [[macOS property list files|Info.plist]] , расположенном в каталоге bundle.app/Contents/.
1010
1111Чтобы получить доступ к набору приложений, вам нужно щелкнуть правой кнопкой мыши (ctrl-левой кнопкой мыши) на пакете и выбрать *Show Package Contents*(Показать содержимое пакета).
1212
13-<figure>
14-<img src="openbundle.png" title="openbundle.png" />
15-<figcaption>openbundle.png</figcaption>
16-</figure>
13+![](/wiki-images/1/12/Openbundle.png)
1714
18-<figure>
19-<img src="infoplist.png" title="infoplist.png" />
20-<figcaption>infoplist.png</figcaption>
21-</figure>
15+![](/wiki-images/8/81/Infoplist.png)
2216
2317## Макет пакета приложения
2418
2519Базовая структура пакета приложений Mac:
2620
2721`MyApp.app/`\
2822`   Contents/`\
2923`      Info.plist`\
3024`      MacOS/`\
3125`      Resources/`
3226
3327| Подпапка каталога Contents | Описание использования |
3428|----|----|
3529| MacOS | (Обязательный) Содержит автономный исполняемый код приложения. Обычно этот каталог содержит только один двоичный файл с основной точкой входа вашего приложения и статически связанным кодом. Однако вы можете поместить в этот каталог и другие автономные исполняемые файлы (например, инструменты командной строки). |
3630| Resources | Содержит все файлы ресурсов приложения. Содержимое этого каталога дополнительно организовано, чтобы различать локализованные и нелокализованные ресурсы. Для получения дополнительных сведений о структуре этого каталога см. [[Add an Apple Help Book to your macOS app|Adding a Help Book - Bundle layouts]]. |
3731| Frameworks | Содержит все частные разделяемые библиотеки и фреймворки, используемые исполняемым файлом. Платформы в этом каталоге привязаны к редакциям приложения и не могут быть заменены никакими другими, даже более новыми версиями, которые могут быть доступны для операционной системы. Другими словами, фреймворки, включенные в этот каталог, имеют приоритет над любыми другими фреймворками с аналогичными названиями в других частях операционной системы. Для получения информации о том, как добавить общие библиотеки в пакет приложений, см. [[macOS Dynamic Libraries]]. |
3832| PlugIns | Содержит загружаемые пакеты, расширяющие базовые функции вашего приложения. Вы используете этот каталог для включения модулей кода, которые должны быть загружены в пространство процесса вашего приложения для использования. Вы не должны использовать этот каталог для хранения автономных исполняемых файлов. |
3933| SharedSupport | Содержит дополнительные некритические ресурсы, которые не влияют на возможность запуска приложения. Вы можете использовать этот каталог для включения таких вещей, как шаблоны документов, картинки и учебные пособия, наличие которых может ожидать ваше приложение, но которые не влияют на способность вашего приложения работать. |
4034
4135## Создание пакета приложения
4236
4337### Посредством Lazarus
4438
4539Откройте проект и перейдите в Project -\> Project Options -\> вкладку Application, и нажмите кнопку [[IDE Window: Project Options/ru|Create Application Bundle]]. Полученный пакет приложений будет содержать символическую ссылку на реальный исполняемый файл.
4640
4741> **Note:** Вы должны удалить символическую ссылку и скопировать реальный исполняемый файл "project1" в каталог project1.app/Contents/MacOS/, если хотите распространять приложение и использовать его на другом компьютере.
4842
4943### Посредством инструмента командной строки, поставляемым с Lazarus
5044
5145Откройте /Library/Lazarus/components/macfiles/examples/createmacapplication.lpi в IDE. Скомпилируйте.
5246
5347Откройте терминал по вашему выбору и введите:
5448
5549``` bash
5650cd project1/
5751/Library/Lazarus/components/macfiles/examples/createmacapplication project1
5852ln -s ../../../project1 project1.app/Contents/MacOS/project1
5953```
6054
6155### Посредством сценария оболочки
6256
6357You 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.
6458
6559- In the debug bundle, a link to the executable is placed, allowing for debugging using the Lazarus IDE,
6660- In the release bundle, the executable is copied so the application bundle as a whole can be used stand-alone/copied to other locations.
6761
6862Вы можете адаптировать следующий сценарий оболочки для создания настраиваемого пакета приложений для вашего приложения. Это позволяет создавать пакеты debug или release.
6963
7064- В пакете debug размещена ссылка на исполняемый файл, что позволяет делать отладку с использованием Lazarus IDE,
7165- В пакете release исполняемый файл копируется, поэтому комплект приложения в целом можно использовать отдельно/скопировать в другие места.
7266
7367``` bash
7468#!/bin/sh
7569# Force Bourne shell in case tcsh is default.
7670#
7771
7872#
7973# Reads the bundle type
8074#
8175
8276echo "========================================================"
8377echo " Bundle creation script"
8478echo "========================================================"
8579echo ""
8680echo " Please select which kind of bundle you would like to build:"
8781echo ""
8882echo " 1 > Debug bundle"
8983echo " 2 > Release bundle"
9084echo " 0 > Exit"
9185
9286read command
9387
9488case $command in
9589
9690 1) ;;
9791
9892 2) ;;
9993
10094 0) exit 0;;
10195
10296 *) echo "Invalid command"
10397 exit 0;;
10498
10599esac
106100
107101#
108102# Creates the bundle
109103#
110104
111105appname=Magnifier
112106appfolder=$appname.app
113107macosfolder=$appfolder/Contents/MacOS
114108plistfile=$appfolder/Contents/Info.plist
115109appfile=magnifier
116110
117111PkgInfoContents="APPLMAG#"
118112
119113#
120114if ! [ -e $appfile ]
121115then
122116 echo "$appfile does not exist"
123117elif [ -e $appfolder ]
124118then
125119 echo "$appfolder already exists"
126120else
127121 echo "Creating $appfolder..."
128122 mkdir $appfolder
129123 mkdir $appfolder/Contents
130124 mkdir $appfolder/Contents/MacOS
131125 mkdir $appfolder/Contents/Frameworks # optional, for including libraries or frameworks
132126 mkdir $appfolder/Contents/Resources
133127
134128#
135129# For a debug bundle,
136130# Instead of copying executable into .app folder after each compile,
137131# simply create a symbolic link to executable.
138132#
139133if [ $command = 1 ]; then
140134 ln -s ../../../$appname $macosfolder/$appname
141135else
142136 cp $appname $macosfolder/$appname
143137fi
144138
145139# Copy the resource files to the correct place
146140 cp *.bmp $appfolder/Contents/Resources
147141 cp icon3.ico $appfolder/Contents/Resources
148142 cp icon3.png $appfolder/Contents/Resources
149143 cp macicon.icns $appfolder/Contents/Resources
150144 cp docs/*.* $appfolder/Contents/Resources
151145#
152146# Create PkgInfo file.
153147 echo $PkgInfoContents >$appfolder/Contents/PkgInfo
154148#
155149# Create information property list file (Info.plist).
156150 echo '<?xml version="1.0" encoding="UTF-8"?>' >$plistfile
157151 echo '<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">' >>$plistfile
158152 echo '<plist version="1.0">' >>$plistfile
159153 echo '<dict>' >>$plistfile
160154 echo ' <key>CFBundleDevelopmentRegion</key>' >>$plistfile
161155 echo ' <string>English</string>' >>$plistfile
162156 echo ' <key>CFBundleExecutable</key>' >>$plistfile
163157 echo ' <string>'$appname'</string>' >>$plistfile
164158 echo ' <key>CFBundleIconFile</key>' >>$plistfile
165159 echo ' <string>macicon.icns</string>' >>$plistfile
166160 echo ' <key>CFBundleIdentifier</key>' >>$plistfile
167161 echo ' <string>org.magnifier.magnifier</string>' >>$plistfile
168162 echo ' <key>CFBundleInfoDictionaryVersion</key>' >>$plistfile
169163 echo ' <string>6.0</string>' >>$plistfile
170164 echo ' <key>CFBundlePackageType</key>' >>$plistfile
171165 echo ' <string>APPL</string>' >>$plistfile
172166 echo ' <key>CFBundleSignature</key>' >>$plistfile
173167 echo ' <string>MAG#</string>' >>$plistfile
174168 echo ' <key>CFBundleVersion</key>' >>$plistfile
175169 echo ' <string>1.0</string>' >>$plistfile
176170 echo '</dict>' >>$plistfile
177171 echo '</plist>' >>$plistfile
178172fi
179173```
180174
181175## Запуск приложения через Application Bundle
182176
183177Вы можете запустить приложение из среды IDE с помощью значка Finder или в собственном MacOS-овском Terminal.app посредством "open project1.app".
184178
185179## См.также
186180
187181- [[macOS property list files]]
188182- [[Add an Apple Help Book to your macOS app]]
189183- [[Hiding a macOS app from the Dock]]
190184
191185## Внешние ссылки
192186
193187- [Apple: NSBundle class](https://developer.apple.com/documentation/foundation/nsbundle)
194188- [Apple: Bundle Resources](https://developer.apple.com/documentation/bundleresources/)
195189- [Apple: CFBundle](https://developer.apple.com/documentation/corefoundation/cfbundle)
196190- [Apple: Bundle Configuration](https://developer.apple.com/documentation/bundleresources/information_property_list/bundle_configuration)
197191- [Apple: Resource Programming Guide](https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/LoadingResources/Introduction/Introduction.html)
198192- [Apple: Bundle Programming Guide](https://developer.apple.com/library/archive/documentation/CoreFoundation/Conceptual/CFBundles/Introduction/Introduction.html)
199193
200194---
201195*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