Sign in Join
Wiki copytemporary

Online Package Manager/es: what changed

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

OldNewLine
11## Acerca de
22
33Online Package Manager(OPM) es una utilidad que automatiza el proceso de instalación, actualización y configuración de los paquetes de Lazarus. Los paquetes se almacenan en el repositorio principal como fichero .zip (ver columna de repositorio), junto con su correspondiente fichero JSON. El fichero JSON contiene toda la información necesaria sobre los paquetes. Realizada la petición los paquetes son descargados/extraidos/compilados/instalados en el IDE. También es posible actualizar un paquete previamente instalado si hay disponible una versión más actualizada en la página web del mantenedor (ver columna update). Hay además disponible una versión del Repositorio de Paquetes de Lazarus en el siguiente enlace: <http://packages.lazarus-ide.org/>.
44
5-` `<span style="color:red">**`Please note:`**</span>`  `\
5+` `**`Please note:`**`  `\
66` OPM lee la descripción del paquete a partir del fichero lpk. I can understand that the description of many packages is very minimalistic or even non-existent, but there is nothing I can do about it. `\
77` It's not OK to modify package description or any other property for that matter, without the consent of the package developer. More over testing each and every package, then write a detailed `\
88` description is not realistic.`
99
1010### Pantallazos
1111
12-<figure>
13-<img src="OPM6.png" title="OPM6.png" />
14-<figcaption>OPM6.png</figcaption>
15-</figure>
12+![](/wiki-images/6/6e/OPM6.png)
1613
17-<figure>
18-<img src="OPM7.png" title="OPM7.png" />
19-<figcaption>OPM7.png</figcaption>
20-</figure>
14+![](/wiki-images/b/b7/OPM7.png)
2115
2216### Licencia
2317
2418[GNU General Public License](https://opensource.org/licenses/gpl-license)
2519
2620### Descargas
2721
2822Online Package Manager (OPM) forma parte de las fuentes de Lazarus. Se encuentra en el directorio (\$LazarusDir)/components/onlinepackagemanager.
2923
3024### Requerimientos del sistema / Dependencias
3125
3226- FPC 3.0.0 o superior.
3327- Lazarus 1.8 o superior.
3428- Puedes descargar una versión más antigua para las series 1.6: [OPM 1.6](https://drive.google.com/open?id=0B9Me_c5onmWobVZOdVlXSlZRRmc)
3529- Estas versiones están disponibles a fecha de escritura de esta actualización.
3630- Testeado en los siguientes widgeset: win32/64, gtk2, carbon, qt(win)
3731- El gestor de paquetes no depende de otros paquetes externos.
3832
3933### Installation
4034
4135In Lazarus "Install/Uninstall Packages" window select "OnlinePackageManager" from the available packages, click "Install selection" and then rebuild the IDE.
4236
4337### Support page
4438
4539<http://forum.lazarus.freepascal.org/index.php/topic,34297.0.html>
4640
4741## Using the package manager
4842
4943### Getting started
5044
5145Go to Lazarus Menu--\>Package--\>Online Package Manager(Shortcut key: \[Ctrl\] + \[Alt\] + O). On startup the package manager will automatically download a list with available repository packages, the list is displayed in a tree(see screenshots above).
5246
5347### Filter the tree/Locate a package
5448
55-<figure>
56-<img src="OPM3.png" title="OPM3.png" />
57-<figcaption>OPM3.png</figcaption>
58-</figure>
49+![](/wiki-images/b/b3/OPM3.png)
5950
6051You can filter the package list by:
6152
6253- Packagename
6354- Package file(.lpk)--\>a repository package can contain multiple lpk files
6455- Package category
6556- Package status
6657- Version
6758- Description
6859- Author
6960- Lazarus compatibility
7061- FPC compatibility
7162- Supported widget sets
7263- Packagetype
7364- Dependencies
7465- License
7566
7667### Operation with packages
7768
78-<figure>
79-<img src="OPM4.png" title="OPM4.png" />
80-<figcaption>OPM4.png</figcaption>
81-</figure>
69+![](/wiki-images/a/a5/OPM4.png)
8270
8371#### Refresh package list
8472
8573Press the "Refresh" button to update the package list.
8674
8775#### Download package
8876
8977Check one or more package then press the "Download" button. This will download/extract the packages to a preselected directory. Nothing gets installed. Useful when you want to install the packages manually or study their sources without installing.
9078
9179#### Install a package
9280
9381Check one or more package then press the "Install" button. The package manager will automatically download/extract/compile/install the selected packages(from the main repository), then rebuild the IDE if necessary(Designtime/Designtime_and_runtime packages). Confirm the rebuild by clicking the "Yes" button. Please note: The compile feature is only available in Lazarus 1.7+.
9482
9583#### Update a package
9684
97-Check one or more package then press the "Update" button. The package manager will update the selected packages from the maintainer's homepage(if available). The package must be installed first, a direct update although is possible, it's not allowed to prevent unresolved dependency error. <span style="color:red">**Please note:**</span> downloading/installing packages from external link is not without a risk. Only update the package if you trust the package maintainer.
85+Check one or more package then press the "Update" button. The package manager will update the selected packages from the maintainer's homepage(if available). The package must be installed first, a direct update although is possible, it's not allowed to prevent unresolved dependency error. **Please note:** downloading/installing packages from external link is not without a risk. Only update the package if you trust the package maintainer.
9886
9987#### Difference between download/install/update
10088
10189Download/Install --\> Operations between you and the main repository.
10290
10391Update --\> Operations between you and the package maintainers.
10492
105-<figure>
106-<img src="OPM10.png" title="OPM10.png" />
107-<figcaption>OPM10.png</figcaption>
108-</figure>
93+![](/wiki-images/6/61/OPM10.png)
10994
11095Video link: [Difference between download/install/update](https://www.youtube.com/watch?v=wiN2GoCvgjc)
11196
11297#### Cleanup local repository
11398
11499This operation will delete all non-installed packages/archives from the local repository. To cleanup the local repository press the "Cleanup" button.
115100
116101#### Create
117102
118103*This section is for package maintainers. First you must go to Options--\>Profiles and select package maintainer.*
119104
120105##### Create repository package
121106
122107To create a repository package press "Create repository package" menu item, then:
123108
124109- select the package main directory(package manager will recursively search for all package files inside the folder)
125110- select the repository package(root node)
126111 - choose category(obligatory)
127112 - type display name(optional)
128113 - home page(optional)
129114 - update link(optional, for more details see "Create JSON for updates"[1](http://wiki.freepascal.org/Online_Package_Manager#Create_JSON_for_updates)" below)
130115 - create JSON for updates(optional), has the same functionality as "Create JSON for updates"[2](http://wiki.freepascal.org/Online_Package_Manager#Create_JSON_for_updates)" dialog. It was also added here to speed up the process.
131116
132-<figure>
133-<img src="OPM15.png" title="OPM15.png" />
134-<figcaption>OPM15.png</figcaption>
135-</figure>
117+![](/wiki-images/6/6c/OPM15.png)
136118
137119- check each package you wish to include, adjust package info if necessary(lazarus/fpc compatibility, supported widgetset, etc)
138120
139-<figure>
140-<img src="OPM16.png" title="OPM16.png" />
141-<figcaption>OPM16.png</figcaption>
142-</figure>
121+![](/wiki-images/6/6d/OPM16.png)
143122
144123- press the create button, if all goes well you should get a zip and a json file. Upload somewhere the files and send the link to getmem1@gmail.com or
145124- press the submit button, the files are directly uploaded to a remote server.
146125
147126Every package will be accepted after a short check(malware, license, etc). Multiple versions of the same package is also allowed.
148127
149128##### Create JSON for updates
150129
151130To allow the user to update the package directly form your webpage, follow this steps:
152131
153132- Make sure your package is already in the main repository(see previous section)
154133- You can download and use the [[OPM External Update json Editor|Online Package Manager External Update json Editor]]
155134 - or via OnlinePackageManager:
156135
157136- Check the package, press the "Create JSON for upates" menu item then create the JSON.
158137
159-<figure>
160-<img src="OPM11.png" title="OPM11.png" />
161-<figcaption>OPM11.png</figcaption>
162-</figure>
138+![](/wiki-images/d/d1/OPM11.png)
163139
164140- Edit the JSON, upload to your webpage, then send me the link.
165141
166142The JSON will look like this:
167143
168-<figure>
169-<img src="OPM12.png" title="OPM12.png" />
170-<figcaption>OPM12.png</figcaption>
171-</figure>
144+![](/wiki-images/0/09/OPM12.png)
172145
173146Editable items in the JSON:
174147
175148**"DownloadZipURL"** --\> Link to your new, updated package
176149
177150**"DisableInOPM"** --\> If you want to temporary disable your package, set this boolean to true. It's useful for maintenance, the package will be grayed out in the tree. The user cannot download/install/update the package.
178151
179152**"Version"/"ForceNotify"/"InternalVersion"** --\> To trigger an update message on the users computer, you can either:
180153
181154- Increase the **"Version"** number. Useful when you want to release a new version of the package.
182155- Set **"ForceNotify"** to true. Useful after a minor change in your source, that does not require a version change or in case of trunk version. To prevent continous error messages, **"ForceNotify"** must be used in combination with **"InternalVersion"**. After the user updates the package, OPM locally stores the **"InternalVersion"** value. If you want to trigger a new message, increase **"InternalVersion"** with one. If **"ForceNotify"** is true, **"Version"** is always ignored.
183156
184157The most common scenario is this:
185158
186159- Generate the JSON
187160- Modify **"DownloadZipURL"**
188161- Increase version number when necessary.
189162
190163Please note: After you edited the JSON the changes are not immediately visible in the tree. Usually it takes 1-2 min. It also depends on the users setting(Options--\>General--\>Check for package updates).
191164
192165#### Options
193166
194167To display the options dialog press the "Options" button.
195168
196169### Create a private repository
197170
198171In order to create a private repository please do the following:
199172
2001731\. First make sure profile "Package maintainer" is enabled in Options--\>Profiles, then open the private repository form(see screenshot below)
201174
202-<figure>
203-<img src="OPM17.png" title="OPM17.png" />
204-<figcaption>OPM17.png</figcaption>
205-</figure>
175+![](/wiki-images/b/b0/OPM17.png)
206176
2071772\. Press the "Create" button. Enter repository Name, Address(optional), Description(optional). Save the repository to an empty folder
208178
209-<figure>
210-<img src="OPM18.png" title="OPM18.png" />
211-<figcaption>OPM18.png</figcaption>
212-</figure>
179+![](/wiki-images/c/c7/OPM18.png)
213180
214181- If filled, the repository address(in this case <http://localhost/packages/>) is automatically added to available repository list(Options form)
215182
216-<figure>
217-<img src="OPM19.png" title="OPM19.png" />
218-<figcaption>OPM19.png</figcaption>
219-</figure>
183+![](/wiki-images/8/8e/OPM19.png)
220184
2211853\. Start to add/delete packages. You have two choices:
222186
223187a\. Create a new package via <http://wiki.freepascal.org/Online_Package_Manager#Create_repository_package>
224188
225189b\. Add a previously saved package
226190
227-<figure>
228-<img src="OPM20.png" title="OPM20.png" />
229-<figcaption>OPM20.png</figcaption>
230-</figure>
191+![](/wiki-images/5/5b/OPM20.png)
231192
2321934.You can also open a previously saved repository. The last repository is automatically opened on startup.
233194
2341955.Upload the files(packagelist.json, *.zip) to your local or remote server.
235196
2361976.Make sure the server is running, the change "Remote repository" in Options--\>General
237198
238199---
239200*From the Free Pascal wiki, page "Online Package Manager/es", as it stood on 2019-10-12 after a change by FTurtle, 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