mirror of
https://gitlab.gnome.org/jwestman/blueprint-compiler.git
synced 2025-05-04 15:59:08 -04:00
9f9a2d94e0
The previous way did not establish dependencies between .ui files and the gresource properly.
71 lines
1.8 KiB
ReStructuredText
71 lines
1.8 KiB
ReStructuredText
=====
|
|
Setup
|
|
=====
|
|
|
|
Setting up Blueprint on a new or existing project
|
|
-------------------------------------------------
|
|
|
|
Using the porting tool
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Clone `blueprint-compiler <https://gitlab.gnome.org/jwestman/blueprint-compiler>`_
|
|
from source. You can install it using `meson _build` and `ninja -C _build install`,
|
|
or you can leave it uninstalled.
|
|
|
|
In your project's directory, run `blueprint-compiler port` (or `<path to blueprint-compiler.py> port`)
|
|
to start the porting process. It will walk you through the steps outlined below.
|
|
It should work for most projects, but if something goes wrong you may need to
|
|
follow the manual steps instead.
|
|
|
|
|
|
Manually
|
|
~~~~~~~~
|
|
|
|
blueprint-compiler works as a meson subproject.
|
|
|
|
#. Save the following file as ``subprojects/blueprint-compiler.wrap``:
|
|
|
|
.. code-block:: cfg
|
|
|
|
[wrap-git]
|
|
directory = blueprint-compiler
|
|
url = https://gitlab.gnome.org/jwestman/blueprint-compiler.git
|
|
revision = main
|
|
depth = 1
|
|
|
|
[provide]
|
|
program_names = blueprint-compiler
|
|
|
|
#. Add this to your ``.gitignore``:
|
|
|
|
.. code-block::
|
|
|
|
/subprojects/blueprint-compiler
|
|
|
|
#. Rewrite your .ui XML files in blueprint format.
|
|
|
|
#. Add this to the ``meson.build`` file where you build your GResources:
|
|
|
|
.. code-block:: meson.build
|
|
|
|
blps = [
|
|
# LIST YOUR BLUEPRINT FILES HERE
|
|
]
|
|
|
|
uis = []
|
|
foreach blp : blps
|
|
uis += blp.replace('.blp', '.ui')
|
|
endforeach
|
|
|
|
blueprints = custom_target('blueprints',
|
|
input: blps,
|
|
output: uis,
|
|
command: [find_program('blueprint-compiler'), 'batch-compile', '@OUTDIR@', '@CURRENT_SOURCE_DIR@', '@INPUT@'],
|
|
)
|
|
|
|
#. In the same ``meson.build`` file, add this argument to your ``gnome.compile_resources`` command:
|
|
|
|
.. code-block:: meson.build
|
|
|
|
dependencies: blueprints,
|
|
|