Sign in Join
Wiki copytemporary

Application Bundle/ru: what changed

Revision 3 to 4. 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
1313![](/wiki-images/1/12/Openbundle.png)
1414
1515![](/wiki-images/8/81/Infoplist.png)
1616
1717## Макет пакета приложения
1818
1919Базовая структура пакета приложений Mac:
2020
21-```
21+```text
2222MyApp.app/
2323 Contents/
2424 Info.plist
2525 MacOS/
2626 Resources/
2727```
2828
2929| Подпапка каталога Contents | Описание использования |
3030|----|----|
3131| MacOS | (Обязательный) Содержит автономный исполняемый код приложения. Обычно этот каталог содержит только один двоичный файл с основной точкой входа вашего приложения и статически связанным кодом. Однако вы можете поместить в этот каталог и другие автономные исполняемые файлы (например, инструменты командной строки). |
3232| Resources | Содержит все файлы ресурсов приложения. Содержимое этого каталога дополнительно организовано, чтобы различать локализованные и нелокализованные ресурсы. Для получения дополнительных сведений о структуре этого каталога см. [[Add an Apple Help Book to your macOS app|Adding a Help Book - Bundle layouts]]. |
3333| Frameworks | Содержит все частные разделяемые библиотеки и фреймворки, используемые исполняемым файлом. Платформы в этом каталоге привязаны к редакциям приложения и не могут быть заменены никакими другими, даже более новыми версиями, которые могут быть доступны для операционной системы. Другими словами, фреймворки, включенные в этот каталог, имеют приоритет над любыми другими фреймворками с аналогичными названиями в других частях операционной системы. Для получения информации о том, как добавить общие библиотеки в пакет приложений, см. [[macOS Dynamic Libraries]]. |
3434| PlugIns | Содержит загружаемые пакеты, расширяющие базовые функции вашего приложения. Вы используете этот каталог для включения модулей кода, которые должны быть загружены в пространство процесса вашего приложения для использования. Вы не должны использовать этот каталог для хранения автономных исполняемых файлов. |
3535| SharedSupport | Содержит дополнительные некритические ресурсы, которые не влияют на возможность запуска приложения. Вы можете использовать этот каталог для включения таких вещей, как шаблоны документов, картинки и учебные пособия, наличие которых может ожидать ваше приложение, но которые не влияют на способность вашего приложения работать. |
3636
3737## Создание пакета приложения
3838
3939### Посредством Lazarus
4040
4141Откройте проект и перейдите в Project -\> Project Options -\> вкладку Application, и нажмите кнопку [[IDE Window: Project Options/ru|Create Application Bundle]]. Полученный пакет приложений будет содержать символическую ссылку на реальный исполняемый файл.
4242
4343> **Note:** Вы должны удалить символическую ссылку и скопировать реальный исполняемый файл "project1" в каталог project1.app/Contents/MacOS/, если хотите распространять приложение и использовать его на другом компьютере.
4444
4545### Посредством инструмента командной строки, поставляемым с Lazarus
4646
4747Откройте /Library/Lazarus/components/macfiles/examples/createmacapplication.lpi в IDE. Скомпилируйте.
4848
4949Откройте терминал по вашему выбору и введите:
5050
5151``` bash
5252cd project1/
5353/Library/Lazarus/components/macfiles/examples/createmacapplication project1
5454ln -s ../../../project1 project1.app/Contents/MacOS/project1
5555```
5656
5757### Посредством сценария оболочки
5858
5959You 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.
6060
6161- In the debug bundle, a link to the executable is placed, allowing for debugging using the Lazarus IDE,
6262- In the release bundle, the executable is copied so the application bundle as a whole can be used stand-alone/copied to other locations.
6363
6464Вы можете адаптировать следующий сценарий оболочки для создания настраиваемого пакета приложений для вашего приложения. Это позволяет создавать пакеты debug или release.
6565
6666- В пакете debug размещена ссылка на исполняемый файл, что позволяет делать отладку с использованием Lazarus IDE,
6767- В пакете release исполняемый файл копируется, поэтому комплект приложения в целом можно использовать отдельно/скопировать в другие места.
6868
6969``` bash
7070#!/bin/sh
7171# Force Bourne shell in case tcsh is default.
7272#
7373
7474#
7575# Reads the bundle type
7676#
7777
7878echo "========================================================"
7979echo " Bundle creation script"
8080echo "========================================================"
8181echo ""
8282echo " Please select which kind of bundle you would like to build:"
8383echo ""
8484echo " 1 > Debug bundle"
8585echo " 2 > Release bundle"
8686echo " 0 > Exit"
8787
8888read command
8989
9090case $command in
9191
9292 1) ;;
9393
9494 2) ;;
9595
9696 0) exit 0;;
9797
9898 *) echo "Invalid command"
9999 exit 0;;
100100
101101esac
102102
103103#
104104# Creates the bundle
105105#
106106
107107appname=Magnifier
108108appfolder=$appname.app
109109macosfolder=$appfolder/Contents/MacOS
110110plistfile=$appfolder/Contents/Info.plist
111111appfile=magnifier
112112
113113PkgInfoContents="APPLMAG#"
114114
115115#
116116if ! [ -e $appfile ]
117117then
118118 echo "$appfile does not exist"
119119elif [ -e $appfolder ]
120120then
121121 echo "$appfolder already exists"
122122else
123123 echo "Creating $appfolder..."
124124 mkdir $appfolder
125125 mkdir $appfolder/Contents
126126 mkdir $appfolder/Contents/MacOS
127127 mkdir $appfolder/Contents/Frameworks # optional, for including libraries or frameworks
128128 mkdir $appfolder/Contents/Resources
129129
130130#
131131# For a debug bundle,
132132# Instead of copying executable into .app folder after each compile,
133133# simply create a symbolic link to executable.
134134#
135135if [ $command = 1 ]; then
136136 ln -s ../../../$appname $macosfolder/$appname
137137else
138138 cp $appname $macosfolder/$appname
139139fi
140140
141141# Copy the resource files to the correct place
142142 cp *.bmp $appfolder/Contents/Resources
143143 cp icon3.ico $appfolder/Contents/Resources
144144 cp icon3.png $appfolder/Contents/Resources
145145 cp macicon.icns $appfolder/Contents/Resources
146146 cp docs/*.* $appfolder/Contents/Resources
147147#
148148# Create PkgInfo file.
149149 echo $PkgInfoContents >$appfolder/Contents/PkgInfo
150150#
151151# Create information property list file (Info.plist).
152152 echo '<?xml version="1.0" encoding="UTF-8"?>' >$plistfile
153153 echo '<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">' >>$plistfile
154154 echo '<plist version="1.0">' >>$plistfile
155155 echo '<dict>' >>$plistfile
156156 echo ' <key>CFBundleDevelopmentRegion</key>' >>$plistfile
157157 echo ' <string>English</string>' >>$plistfile
158158 echo ' <key>CFBundleExecutable</key>' >>$plistfile
159159 echo ' <string>'$appname'</string>' >>$plistfile
160160 echo ' <key>CFBundleIconFile</key>' >>$plistfile
161161 echo ' <string>macicon.icns</string>' >>$plistfile
162162 echo ' <key>CFBundleIdentifier</key>' >>$plistfile
163163 echo ' <string>org.magnifier.magnifier</string>' >>$plistfile
164164 echo ' <key>CFBundleInfoDictionaryVersion</key>' >>$plistfile
165165 echo ' <string>6.0</string>' >>$plistfile
166166 echo ' <key>CFBundlePackageType</key>' >>$plistfile
167167 echo ' <string>APPL</string>' >>$plistfile
168168 echo ' <key>CFBundleSignature</key>' >>$plistfile
169169 echo ' <string>MAG#</string>' >>$plistfile
170170 echo ' <key>CFBundleVersion</key>' >>$plistfile
171171 echo ' <string>1.0</string>' >>$plistfile
172172 echo '</dict>' >>$plistfile
173173 echo '</plist>' >>$plistfile
174174fi
175175```
176176
177177## Запуск приложения через Application Bundle
178178
179179Вы можете запустить приложение из среды IDE с помощью значка Finder или в собственном MacOS-овском Terminal.app посредством "open project1.app".
180180
181181## См.также
182182
183183- [[macOS property list files]]
184184- [[Add an Apple Help Book to your macOS app]]
185185- [[Hiding a macOS app from the Dock]]
186186
187187## Внешние ссылки
188188
189189- [Apple: NSBundle class](https://developer.apple.com/documentation/foundation/nsbundle)
190190- [Apple: Bundle Resources](https://developer.apple.com/documentation/bundleresources/)
191191- [Apple: CFBundle](https://developer.apple.com/documentation/corefoundation/cfbundle)
192192- [Apple: Bundle Configuration](https://developer.apple.com/documentation/bundleresources/information_property_list/bundle_configuration)
193193- [Apple: Resource Programming Guide](https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/LoadingResources/Introduction/Introduction.html)
194194- [Apple: Bundle Programming Guide](https://developer.apple.com/library/archive/documentation/CoreFoundation/Conceptual/CFBundles/Introduction/Introduction.html)
195195
196196---
197197*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