Deploying Your Application/pt: what changed

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

Old	New		Line
1		-	~~## Contents~~
2		-
3		-	* 1 Instaladores para Windows
4		-	* 1.1 InnoSetup
5		-	* 1.2 InstallJammer
6		-	* 1.3 HJ-Install
7		-	* 1.4 LizaJet Installer
8		-	* 1.5 NSIS (Nullsoft Scriptable Install System)
9		-	* 1.6 Grupo de Ferramentas para Windows Installer XML (WiX)
10		-	* 2 Instaladores para Unix
11		-	* 2.1 Criando um pacote RPM em Linux
12		-	* 2.1.1 Configurando o seu ambiente de construção
13		-	* 2.1.2 Criando um pacote somente binário
14		-	* 2.1.3 Creating a source and binary package
15		-	* 2.2 Creating a Debian Package on Linux
16		-	* 2.3 GUInseng
17		-	* 3 Creating a Makefile for your Lazarus software
18		-	* 4 macOS installers
19		-	* 4.1 Using PackageMaker on macOS
20		-	* 4.2 Installing X11 and GTK on macOS
21		-
22	1		## Instaladores para Windows
23	2
24	3		### InnoSetup
25	4
26		-	O Inno Setup é um instalador free para programas Windows. Pode ser usado completamente sem encargos, mesmo quando distribuído com aplicações comerciais. Fontes completos estâo disponìveis (Borland Delphi 2.0-5.0). (<http://www.jrsoftware.org/>).
	5	+	O Inno Setup é um instalador free para programas Windows. Pode ser usado completamente sem encargos, mesmo quando distribuído com aplicações comerciais. Fontes completos estâo disponìveis (Borland Delphi 2.0-5.0). (http://www.jrsoftware.org/).
27	6
28		-	Suporta todas as versões do Windows em uso hoje -- Windows 95, 98, 2000, 2003, XP, Me, NT 4.0. O instalador tem a habilidade de comparar informações de versão de arquivo, substituir arquivos in-use, usar contagem de arquivo compartilhado, registrar DLL/OCX e bibliotecas de tipo e instalar fontes. Criação de atalhos em qualquer lugar, incluindo o Menu Iniciar e a Área de Trabalho. Criação de entradas de registro e de arquivos INI. Pascal Scripting Engine integrada. Suporte para instalação multilíngüe. Suporte para senha e instalações encriptadas. Instalação e desinstalação silenciosas.
	7	+	Suporta todas as versões do Windows em uso hoje -- Windows 95, 98, 2000, 2003, XP, Me, NT 4.0. O instalador tem a habilidade de comparar informações de versão de arquivo, substituir arquivos in-use, usar contagem de arquivo compartilhado, registrar DLL/OCX e bibliotecas de tipo e instalar fontes. Criação de atalhos em qualquer lugar, incluindo o Menu Iniciar e a Área de Trabalho. Criação de entradas de registro e de arquivos INI. Pascal Scripting Engine integrada. Suporte para instalação multilíngüe. Suporte para senha e instalações encriptadas. Instalação e desinstalação silenciosas.
29	8
30		-	O Inno Setup tem copyrigt, não é um software de domínio público. Existem algumas restriçôes na distribuiçâo e uso; veja o arquivo <http://www.jrsoftware.org/files/is/license.txt> para detalhes.
	9	+	O Inno Setup tem copyrigt, não é um software de domínio público. Existem algumas restriçôes na distribuiçâo e uso; veja o arquivo <http://www.jrsoftware.org/files/is/license.txt> para detalhes.
31	10
32		-	~~O Inno Setup é usado para criar o instalador do Lazarus para Windows.~~
	11	+	O Inno Setup é usado para criar o instalador do Lazarus para Windows.
33	12
34	13		### InstallJammer
35	14
36		-	[InstallJammer](<http://www.installjammer.com/>), um instalador GUI multiplataforma e de código aberto, desenhado para ser completamente cross-plataforma e funcionar em Windows e na maioria das versões de UNIX, com suporte eventual a macOS.
	15	+	[InstallJammer](http://www.installjammer.com/), um instalador GUI multiplataforma e de código aberto, desenhado para ser completamente cross-plataforma e funcionar em Windows e na maioria das versões de UNIX, com suporte eventual a macOS.
37	16
38	17		### HJ-Install
39	18
40	19		HJ-Install é um instalador freeware para Windows 95, 98 ME, NT 4.0, 200 e XP. Ele foi criado com intenções de instalar pela internet, por CD-Rom ou por floppy disk único ou múltiplo, mas pode também ser usado em situações de rede e como uma scripting engine stand-alone. O instalador é pequeno e adiciona apenas 138 Kb. Não suporta modificações no registro e arquivos INI, ou desinstalação. Veja em <http://www.freebyte.com/hjinstall/>
41	20
42	21		### LizaJet Installer
43	22
44	23		O LizaJet Installer é um instalador comercial, mas uma edição free está disponível. Usa Object Pascal para script. Veja em <http://www.lizajet.com>
45	24
46	25		### NSIS (Nullsoft Scriptable Install System)
47	26
48	27		Um sistema de código aberto profissional para criar instaladores Windows. Um instalador NSIS completo tem um overhead de apenas 34 Kb. Veja em <http://nsis.sourceforge.net/Main_Page> and <http://hmne.sourceforge.net/>
49	28
50	29		### Grupo de Ferramentas para Windows Installer XML (WiX)
51	30
52	31		Um grupo de ferramentas que constrói pacotes de instalação para Windos de código fonte XML. Elas suportam um ambiente de linha de comando que os desenvolvedore podem integrar em seus processos que construção para construir pacotes de instalação MSI e MSN. Veja em <http://wix.sourceforge.net/>
53	32
54	33		## Instaladores para Unix
55	34
56	35		### Criando um pacote RPM em Linux
57	36
58		-	No Linux, a melhor maneira de distribuir aplicações é usando o sistema de pacotes nativo. Dos muitos sistemas de pacotes disponíveis, o RPM (RedHat Package Manager) é o formato mais comumente utilizado e é definido como o padrão na Linux Standard Base.
	37	+	No Linux, a melhor maneira de distribuir aplicações é usando o sistema de pacotes nativo. Dos muitos sistemas de pacotes disponíveis, o RPM (RedHat Package Manager) é o formato mais comumente utilizado e é definido como o padrão na Linux Standard Base.
59	38
60		-	Para criar um arquivo RPM, você precisa criar um arquivo texto spec com a informação necessária para construir o software e também um ambiente para construir aquele spec. O melhor editor para criar pacotes RPM é o Emacs, porque ele reconhece a extensão spec, faz a synthax-highlight do texto de maneira apropriada e tem até um item de menu para construir pacotes RPM.
	39	+	Para criar um arquivo RPM, você precisa criar um arquivo texto spec com a informação necessária para construir o software e também um ambiente para construir aquele spec. O melhor editor para criar pacotes RPM é o Emacs, porque ele reconhece a extensão spec, faz a synthax-highlight do texto de maneira apropriada e tem até um item de menu para construir pacotes RPM.
61	40
62	41		#### Configurando o seu ambiente de construção
63	42
64		-	Pacotes RPM são instalados como root no sistema base (/ directory), mas um acidente como root pode destruir sua máquina. Para evitar isso, pacotes podem ser construídos como uso normal. O processo de construção inclui uma instalação real, para se certificar e que os pacotes funcionam, mas esta instalação é feita para um diretório root falso representado pela variável $RPM_BUILD_ROOT.
	43	+	Pacotes RPM são instalados como root no sistema base (/ directory), mas um acidente como root pode destruir sua máquina. Para evitar isso, pacotes podem ser construídos como uso normal. O processo de construção inclui uma instalação real, para se certificar e que os pacotes funcionam, mas esta instalação é feita para um diretório root falso representado pela variável \$RPM_BUILD_ROOT.
65	44
66		-	~~Primeiro vá ao diretório home (ou outro diretório dentro dele) e crie a seguinte estrutura de diretório:~~
	45	+	Primeiro vá ao diretório home (ou outro diretório dentro dele) e crie a seguinte estrutura de diretório:
67	46
68		-	~~RPM~~
	47	+	RPM
69	48
70		-	~~RPM/BUILD - Este diretório é utilizado pelo RPM para construir o pacote.~~
	49	+	RPM/BUILD - Este diretório é utilizado pelo RPM para construir o pacote.
71	50
72		-	~~RPM/RPMS - Aqui você pode encontrar RPMs binários depois de construí-los.~~
	51	+	RPM/RPMS - Aqui você pode encontrar RPMs binários depois de construí-los.
73	52
74		-	~~RPM/SOURCES - Ponha seus arquivos comprimidos tar e patches aqui.~~
	53	+	RPM/SOURCES - Ponha seus arquivos comprimidos tar e patches aqui.
75	54
76		-	~~RPM/SPECS - Ponha todos os seus arquivos spec aqui.~~
	55	+	RPM/SPECS - Ponha todos os seus arquivos spec aqui.
77	56
78		-	~~RPM/SRPMS - Here you can find source RPMs after you build them.~~
	57	+	RPM/SRPMS - Here you can find source RPMs after you build them.
79	58
80		-	Next you will need to create a configuration file to tell rpm builder software where he can find your build directories. Go to your home directory and create a file named .rpmmacros and place the text bellow on it. Make sure to change the directories to the correct ones on your system.
81		-	~~```~~
82		-	~~%_topdir /home/felipe/RPM/~~
	59	+	Next you will need to create a configuration file to tell rpm builder software where he can find your build directories. Go to your home directory and create a file named .rpmmacros and place the text bellow on it. Make sure to change the directories to the correct ones on your system.
	60	+
	61	+	%_topdir /home/felipe/RPM/
83	62		%_tmppath /home/felipe/tmp
84		-
	63	+
85	64		%_signature gpg
86	65		%_gpg_name Mandrakelinux
87	66		%_gpg_path ~/.gnupg
88		-	~~```~~
89	67
90	68		#### Criando um pacote somente binário
91	69
92		-	~~A maneira mais fácil de criar pacotes RPM é fazêe-lo instalar software já compilado. Existem algumas razões por que nós podemos querer evitar de compilar o software em um arquivo spec:~~
	70	+	A maneira mais fácil de criar pacotes RPM é fazêe-lo instalar software já compilado. Existem algumas razões por que nós podemos querer evitar de compilar o software em um arquivo spec:
93	71
94		-	* Requer a criação de um Makefile e eles são complexos
	72	+	- Requer a criação de um Makefile e eles são complexos
95	73
96		-	* Alguns pacotes não têm qualquer binário neles e não precisam ser construídos.
	74	+	- Alguns pacotes não têm qualquer binário neles e não precisam ser construídos.
97	75
98		-	Each RPM Package contains a single compressed tar archive. Place the archive under the RPM/SOURCES directory. Zip, gz and bz2 compressions should work ok. The file can either contain the full source of the project if you with to create a source and a binary package or a directory with the files already in place, like if they were installed in the user machine, if you with to create a binary only package.
	76	+	Each RPM Package contains a single compressed tar archive. Place the archive under the RPM/SOURCES directory. Zip, gz and bz2 compressions should work ok. The file can either contain the full source of the project if you with to create a source and a binary package or a directory with the files already in place, like if they were installed in the user machine, if you with to create a binary only package.
99	77
100		-	Para construir um pacote binário abra um arquivo spec com o editor de texto Emacs. No Emacs abra o menu RPM spec --> RPM Build --> Build Binary Package. Isto vai criar um arquivo RPM no diretório RPM/RPMS.
	78	+	Para construir um pacote binário abra um arquivo spec com o editor de texto Emacs. No Emacs abra o menu RPM spec --\> RPM Build --\> Build Binary Package. Isto vai criar um arquivo RPM no diretório RPM/RPMS.
101	79
102		-	Bellow is a spec file that doesn't build the software. In this case the software is a Braille Course composed of html and Macromedia Flash files. Flash files cannot be build on Linux, so it's not possible to create a source package in this case.
103		-	~~```~~
104		-	~~%define name braillevirtual~~
	80	+	Bellow is a spec file that doesn't build the software. In this case the software is a Braille Course composed of html and Macromedia Flash files. Flash files cannot be build on Linux, so it's not possible to create a source package in this case.
	81	+
	82	+	%define name braillevirtual
105	83		%define version 1.0
106	84		%define release mdk
107	85		%define dir braillevirtual
108	86		%define root /home/felipe/tmp/ROOT/
109		-
	87	+
110	88		Summary: Curso On-Line de Braille
111	89		Name: %{name}
112	90		Version: %{version}
113	91		Release: %{release}
114	92		Vendor: Laboratório de Brinquedos da Faculdade de Educação da USP
115	93		URL: www.braillevirtual.fe.usp.br
116	94		License: Distribuível livremente
117	95		Group: Books/Other
118	96		Packager: Felipe Monteiro de Carvalho
119	97		Source0: home/felipe/Programacao/SOURCES/braillevirtual.tar.bz2
120		-	~~BuildRoot: %{root}~~
121		-
	98	+	BuildRoot: %{root}
	99	+
122	100		%description
123	101		O Braille Virtual é um curso on-line público e gratuito destinado à difusão e ensino do sistema Braille de leitura e escrita para cegos a pessoas que vêem. É orientado especialmente a pais, crianças, professores e funcionários de escolas inclusivas e pretende facilitar a comunicação entre estas pessoas e as pessoas com cegueira.
124		-
	102	+
125	103		%prep
126	104		cd $RPM_SOURCE_DIR
127	105		cp braillevirtual.tar.bz2 $RPM_BUILD_DIR
128	106		cd $RPM_BUILD_DIR
129		-	~~rm -rf %{dir}~~
	107	+	rm -rf %{dir}
130	108		rm -f braillevirtual.tar
131	109		bunzip2 -d braillevirtual.tar.bz2
132	110		tar -xvf braillevirtual.tar
133		-
	111	+
134	112		%install
135	113		rm -rf $RPM_BUILD_ROOT/usr/share/%{dir}
136	114		cp -r $RPM_BUILD_DIR/%{dir} $RPM_BUILD_ROOT/usr/share/
137		-
	115	+
138	116		%clean
139	117		rm -rf $RPM_BUILD_DIR/.
140		-
	118	+
141	119		%files
142	120		/usr/share/%{dir}/
143		-
	121	+
144	122		%changelog
145		-
	123	+
146	124		* Mon Oct 24 2005 1.0-mdk.noarch.rpm
147		-
	125	+
148	126		- Nova atualização do pacote de instalação. Inclusão dos exercícios avançados.
149		-
	127	+
150	128		* Wed May 12 2005 1.0-mdk.noarch.rpm
151		-
	129	+
152	130		- Atualizei o pacote para refletir as mudanças no site. Várias pequenas mudanças.
153		-
	131	+
154	132		* Sun May 05 2005 1.0-1mdk.i586.rpm
155		-
	133	+
156	134		- O pacote de instalação do braille Virtual para linux é criado.
157		-	~~```~~
158	135
159	136		#### Creating a source and binary package
160	137
161		-	Linux distributions only accept RPM packages that can build the software. This will probably require creating build scripts and/or a Makefile. For more information see the section [[Deploying Your Application\|Deploying_Your_Application#Creating_a_Makefile_for_your_Lazarus_software]].
	138	+	Linux distributions only accept RPM packages that can build the software. This will probably require creating build scripts and/or a Makefile. For more information see the section [[Deploying Your Application\|Deploying_Your_Application#Creating_a_Makefile_for_your_Lazarus_software]].
162	139
163		-	~~You need to use the %build section to compile the software.~~
	140	+	You need to use the %build section to compile the software.
164	141
165		-	~~Bellow is an example of a spec file capable of building the software. Be very careful when studing this as every little detail is important and follows a precise pattern.~~
166		-	~~```~~
167		-	~~Name: magnifier~~
	142	+	Bellow is an example of a spec file capable of building the software. Be very careful when studing this as every little detail is important and follows a precise pattern.
	143	+
	144	+	Name: magnifier
168	145		Version: 3.2.1
169	146		Release: 1
170	147		Summary: Virtual Magnifying Glass
171	148		Group: Accessibility
172	149		License: GPL Version 2
173	150		URL: http://magnifier.sourceforge.net
174	151		Source0: http://internap.dl.sourceforge.net/sourceforge/magnifier/magnifier-3.2.1.zip
175	152		BuildRoot: %{_tmppath}/%{name}-%{version}-%{release}-root-%(%{__id_u} -n)
176	153		BuildRequires: fpc >= 2.0.2, lazarus >= 0.9.12
177	154		Requires: ImageMagick
178		-
	155	+
179	156		%description
180		-
	157	+
181	158		Virtual Magnifying Glass is a free, open source, multiplatform, screen magnification tool. It is simple, customizable, and easy-to-use.
182		-
	159	+
183	160		%prep
184	161		%setup -q magnifier
185		-
	162	+
186	163		%build
187	164		make TARGET=%{_target_cpu}
188		-
	165	+
189	166		%install
190	167		./install.sh DESTDIR=$RPM_BUILD_ROOT
191		-
	168	+
192	169		%clean
193	170		rm -rf $RPM_BUILD_ROOT/
194		-
	171	+
195	172		%files
196	173		%defattr(-,root,root,-)
197	174		/usr/share/magnifier/
198	175		/usr/bin/magnifier
199		-
	176	+
200	177		%changelog
201		-
	178	+
202	179		* Wed Feb 15 2006 Felipe Monteiro de Carvalho <felipemonteiro.carvalho at gmail.com> - 3.2-mdk.i386.rpm
203	180		- The Linux RPM package is created.
204		-	~~```~~
205	181
206	182		### Creating a Debian Package on Linux
207	183
208	184		Please, write me.
209	185
210		-	~~In the mean time have a look at this tutorial written by IBM.~~
	186	+	In the mean time have a look at this tutorial written by IBM.\
211	187		<http://www-128.ibm.com/developerworks/linux/library/l-debpkg.html>
212	188
213	189		### GUInseng
214	190
215		-	~~[GUInseng](<http://www.guinseng.de/>) is a a GTK+ based installer for Linux released under GPL.~~
	191	+	[GUInseng](http://www.guinseng.de/) is a a GTK+ based installer for Linux released under GPL.
216	192
217	193		## Creating a Makefile for your Lazarus software
218	194
219		-	The following is a command line build system for a Lazarus software. This is particularly usefull if you with to create a RPM package suitable for inclusing on GNU/Linux distributions. The comments on the files should explain what each part does.
	195	+	The following is a command line build system for a Lazarus software. This is particularly usefull if you with to create a RPM package suitable for inclusing on GNU/Linux distributions. The comments on the files should explain what each part does.
220	196
221		-
222		-	~~make.sh~~
223		-	~~```~~
224		-	#
	197	+	make.sh
	198	+
	199	+	#
225	200		# Detects and parses the architecture
226	201		#
227		-
	202	+
228	203		ARCH=$(uname -m)
229		-
	204	+
230	205		case "$ARCH" in
231		-
	206	+
232	207		"i686") ARCH="i386";;
233		-
	208	+
234	209		"i586") ARCH="i386";;
235		-
	210	+
236	211		"i486") ARCH="i386";;
237		-
	212	+
238	213		esac
239		-
	214	+
240	215		echo "Target architecture: $ARCH"
241		-
	216	+
242	217		#
243	218		# Detects and parses the OS
244	219		#
245		-
	220	+
246	221		OS="linux"
247		-
	222	+
248	223		echo "Target operating system: $OS"
249		-
250		-
	224	+
251	225		#
252	226		# Command line to build the sofware
253	227		#
254		-
	228	+
255	229		fpc -S2cgi -OG1 -gl -WG -vewnhi -l -Fu/usr/lib/lazarus/components/opengl/gtk2x11/ -Fi/usr/lib/lazarus/components/opengl/gtk2x11/include/ -Fu/usr/lib/lazarus/components/jpeg/ -Fu/usr/lib/lazarus/lcl/units/$ARCH-$OS/ -Fu/usr/lib/lazarus/lcl/units/$ARCH-$OS/ -Fu/usr/lib/lazarus/lcl/units/$ARCH-$OS/gtk2/ -Fu/usr/lib/lazarus/packager/units/$ARCH-$OS/ -Fu. -o./magnifier -dLCL -dLCLgtk2 magnifier.dpr
256		-	~~```~~
257	230
258		-	~~install.sh~~
259		-	~~```~~
260		-	#
	231	+	install.sh
	232	+
	233	+	#
261	234		# Parses command line options. Currently supported options are:
262	235		#
263		-	~~# DESTDIR Destination root directory~~
	236	+	# DESTDIR Destination root directory
264	237		#
265		-
	238	+
266	239		DESTDIR=""
267		-
	240	+
268	241		for arg; do
269		-
	242	+
270	243		case $arg in
271		-
	244	+
272	245		DESTDIR=*) DESTDIR=${arg#DESTDIR=};;
273		-
	246	+
274	247		esac;
275		-
	248	+
276	249		done
277		-
	250	+
278	251		#
279	252		# Does the install
280	253		#
281	254		# "mkdir -p" is equivalent to ForceDirectories pascal function
282	255		#
283		-
	256	+
284	257		mkdir -p $DESTDIR/usr/share/magnifier
285		-
	258	+
286	259		cp ./topleft.bmp $DESTDIR/usr/share/magnifier/
287	260		cp ./topright.bmp $DESTDIR/usr/share/magnifier/
288	261		cp ./bottomleft.bmp $DESTDIR/usr/share/magnifier/
289	262		cp ./bottomright.bmp $DESTDIR/usr/share/magnifier/
290	263		cp ./top.bmp $DESTDIR/usr/share/magnifier/
291	264		cp ./left.bmp $DESTDIR/usr/share/magnifier/
292	265		cp ./bottom.bmp $DESTDIR/usr/share/magnifier/
293	266		cp ./right.bmp $DESTDIR/usr/share/magnifier/
294	267		cp ./icon3.ico $DESTDIR/usr/share/magnifier/
295		-
	268	+
296	269		mkdir -p $DESTDIR/usr/bin
297		-
	270	+
298	271		cp ./magnifier $DESTDIR/usr/bin/
299		-	~~```~~
300	272
301		-	~~clean.sh~~
302		-	~~```~~
303		-	~~rm -rf *.o~~
	273	+	clean.sh
	274	+
	275	+	rm -rf *.o
304	276		rm -rf *.ppu
305		-
	277	+
306	278		rm -rf *.pas~
307	279		rm -rf *.sh~
308	280		rm -rf *.bak
309		-
	281	+
310	282		rm -rf *~
311		-
	283	+
312	284		rm -rf magnifier
313		-	~~```~~
314	285
315		-	~~uninstall.sh~~
316		-	~~```~~
317		-	#
	286	+	uninstall.sh
	287	+
	288	+	#
318	289		# Don´t use "rm -rf" in here, because you should only remove the files you created
319	290		#
320	291		rm -f /usr/share/magnifier/topleft.bmp
321	292		rm -f /usr/share/magnifier/topright.bmp
322	293		rm -f /usr/share/magnifier/bottomleft.bmp
323	294		rm -f /usr/share/magnifier/bottomright.bmp
324	295		rm -f /usr/share/magnifier/top.bmp
325	296		rm -f /usr/share/magnifier/left.bmp
326	297		rm -f /usr/share/magnifier/bottom.bmp
327	298		rm -f /usr/share/magnifier/right.bmp
328	299		rm -f /usr/share/magnifier/icon3.ico
329		-
	300	+
330	301		rm -f /usr/share/magnifier/magnifier
331		-
	302	+
332	303		rm -f /usr/bin/magnifier
333		-
	304	+
334	305		rmdir /usr/share/magnifier
335		-	~~```~~
336	306
337		-	~~Makefile~~
338		-	~~```~~
339		-	#
	307	+	Makefile
	308	+
	309	+	#
340	310		# Targets
341	311		#
342		-
	312	+
343	313		#
344	314		# The First target is the one build when there is nothing on make command line
345	315		#
346	316		all:
347		-	~~./make.sh~~
348		-
	317	+	./make.sh
	318	+
349	319		clean:
350		-	~~./clean.sh~~
351		-
	320	+	./clean.sh
	321	+
352	322		install:
353		-	~~./install.sh~~
354		-
355		-	~~uninstall:~~
356		-	~~./uninstall.sh~~
357		-	~~```~~
	323	+	./install.sh
358	324
359		-
	325	+	uninstall:
	326	+	./uninstall.sh
360	327
361	328		## macOS installers
362	329
363	330		### Using PackageMaker on macOS
364	331
365		-	Most macOS programs are distributed as a disk image file (.dmg extension). Normally you download or copy a program's .dmg file to your Mac and double-click it. This "mounts" the disk image and opens it in a window on the desktop, where you'll typically see a package file (.pkg extension) that you double-click to perform the actual program installation. After installation is complete, you "unmount" (eject) the mounted disk image by dragging it to the trash. You can also delete the .dmg file by dragging it to the trash as well.
	332	+	Most macOS programs are distributed as a disk image file (.dmg extension). Normally you download or copy a program's .dmg file to your Mac and double-click it. This "mounts" the disk image and opens it in a window on the desktop, where you'll typically see a package file (.pkg extension) that you double-click to perform the actual program installation. After installation is complete, you "unmount" (eject) the mounted disk image by dragging it to the trash. You can also delete the .dmg file by dragging it to the trash as well.
366	333
367		-	The installer .pkg file is actually a directory, as is the resulting application bundle (.app extension) that it copies to the Applications folder. To the user, .pkg and .app files look and act like ordinary files, but they're really directories whose details have been hidden from the user. You can see what's inside a .pkg or .app file by entering normal cd commands in a terminal window (for example, cd progname.app) or by Ctrl-clicking the file and choosing Show Package Contents from the popup menu.
	334	+	The installer .pkg file is actually a directory, as is the resulting application bundle (.app extension) that it copies to the Applications folder. To the user, .pkg and .app files look and act like ordinary files, but they're really directories whose details have been hidden from the user. You can see what's inside a .pkg or .app file by entering normal cd commands in a terminal window (for example, cd progname.app) or by Ctrl-clicking the file and choosing Show Package Contents from the popup menu.
368	335
369		-	You create .pkg files using PackageMaker, which is installed along with the XCode tools in /Developer/Applications/Utilities. With PackageMaker, you select the folder containing the files you want to package and set other installation options, for example whether a password must be entered to install the program. Note that the folder you select can be an .app file. Choose File \| Create Package to create the .pkg file. You can also save your settings for future use in PackageMaker by choosing File \| Save to create a .pmsp file that you name (.pmproj with later versions).
	336	+	You create .pkg files using PackageMaker, which is installed along with the XCode tools in /Developer/Applications/Utilities. With PackageMaker, you select the folder containing the files you want to package and set other installation options, for example whether a password must be entered to install the program. Note that the folder you select can be an .app file. Choose File \\| Create Package to create the .pkg file. You can also save your settings for future use in PackageMaker by choosing File \\| Save to create a .pmsp file that you name (.pmproj with later versions).
370	337
371		-	To create a .dmg file, run the macOS Disk Utility, which is installed in /Applications/ Utilities. Select Images \| New \| Image from Folder and choose the folder containing your .pkg file and any other files you want to include in the disk image. In the Convert Image dialog, enter the name of the .dmg file to create, select where it should be saved, and select "compressed" as the image format. The .dmg file that Disk Utility creates is then ready for distribution.
	338	+	To create a .dmg file, run the macOS Disk Utility, which is installed in /Applications/ Utilities. Select Images \\| New \\| Image from Folder and choose the folder containing your .pkg file and any other files you want to include in the disk image. In the Convert Image dialog, enter the name of the .dmg file to create, select where it should be saved, and select "compressed" as the image format. The .dmg file that Disk Utility creates is then ready for distribution.
372	339
373	340		### Installing X11 and GTK on macOS
374	341
375		-	GUI apps created with Lazarus that use the GTK widgetset require X11 and the GTK libraries to run. X11 is included with macOS, but may not be installed by default on a user's Mac, so you'll want to mention this in your app's read-me file.
	342	+	GUI apps created with Lazarus that use the GTK widgetset require X11 and the GTK libraries to run. X11 is included with macOS, but may not be installed by default on a user's Mac, so you'll want to mention this in your app's read-me file.
376	343
377	344		To install the GTK libraries on a user's system, you could include instructions for using fink. Or you could create a separate .dmg file containing just the files from the /sw/lib folder on your Mac. If you don't want to install all of the subfolders under the /sw/lib folder, copy just the .dylib files from /sw/lib to a different folder and package this folder instead of /sw/lib. Also, remember that the GTK libraries installed on your Mac are specific to the processor that you're running. That is, if you want to support both PowerPC and Intel Macs you'll need to create two different .dmg files and instruct your users to install the appropriate one. Note that the GTK libraries only need to be installed once and can be used with any number of Lazarus GUI programs that you develop.
378	345
379	346		---
380		-	From the Free Pascal wiki, page "Deploying Your Application/pt", as the Internet Archive kept it on 2023-01-27. 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).
	347	+	From the Free Pascal wiki, page "Deploying Your Application/pt", as it stood on 2020-02-29 after a change by Trev, 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