Paquetatge d'aplicacions i programes PyGObject com a paquet .deb per a l'escriptori Linux - Part 4


Continuem la sèrie de programació PyGObject amb tu a l'escriptori Linux, a la 4a part de la sèrie t'explicarem com empaquetar els programes i les aplicacions que hem creat per al Escriptori Linux utilitzant PyGObject com a paquet Debian.

Els paquets Debian (.deb) són el format més utilitzat per instal·lar programes sota Linux, el sistema \dpkg que tracta els paquets .deb és l'opció predeterminada a totes les distribucions de Linux basades en Debian com Ubuntu i Linux Mint. És per això que només explicarem com empaquetar els nostres programes per a Debian.

Creeu un paquet Debian des de les vostres aplicacions PyGObject

Primer, hauríeu de tenir uns coneixements bàsics sobre la creació de paquets Debian, aquesta guia us ajudarà molt.

  1. Introducció als paquets de Debian

En resum, si teniu un projecte anomenat \myprogram, ha de contenir els fitxers i carpetes següents perquè pugueu empaquetar-lo.

  1. debian (Carpeta): aquesta carpeta inclou tota la informació sobre el paquet Debian dividida en molts subfitxers.
  2. po (Carpeta): la carpeta po inclou els fitxers de traducció del programa (ho explicarem a la part 5).
  3. el meu programa (Fitxer): aquest és el fitxer Python que hem creat amb PyGObject, és el fitxer principal del projecte.
  4. ui.glade (Fitxer): el fitxer de la interfície gràfica d'usuari.. Si heu creat la interfície de l'aplicació amb Glade, heu d'incloure aquest fitxer a
    el teu projecte.
  5. bMyprogram.desktop (Fitxer): aquest és el fitxer responsable de mostrar l'aplicació al menú d'aplicacions.
  6. setup.py (Fitxer): aquest fitxer és el responsable d'instal·lar qualsevol programa Python al sistema local, és molt important en qualsevol programa Python, també té moltes altres maneres d'utilitzar-se.

Per descomptat.. Hi ha molts altres fitxers i carpetes que pots incloure al teu projecte (de fet pots incloure el que vulguis) però aquests són els bàsics.

Ara, comencem a empaquetar un projecte. Creeu una carpeta nova anomenada \myprogram, creeu un fitxer anomenat \myprogram i afegiu-hi el codi següent.

#!/usr/bin/python 
# -*- coding: utf-8 -*- 

## Replace your name and email. 
# My Name <[email > 

## Here you must add the license of the file, replace "MyProgram" with your program name. 
# License: 
#    MyProgram is free software: you can redistribute it and/or modify 
#    it under the terms of the GNU General Public License as published by 
#    the Free Software Foundation, either version 3 of the License, or 
#    (at your option) any later version. 
# 
#    MyProgram is distributed in the hope that it will be useful, 
#    but WITHOUT ANY WARRANTY; without even the implied warranty of 
#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the 
#    GNU General Public License for more details. 
# 
#    You should have received a copy of the GNU General Public License 
#    along with MyProgram.  If not, see <http://www.gnu.org/licenses/>. 

from gi.repository import Gtk 
import os 

class Handler: 
  
  def openterminal(self, button): 
    ## When the user clicks on the first button, the terminal will be opened. 
    os.system("x-terminal-emulator ") 
  
  def closeprogram(self, button): 
    Gtk.main_quit() 
    
# Nothing new here.. We just imported the 'ui.glade' file. 
builder = Gtk.Builder() 
builder.add_from_file("/usr/lib/myprogram/ui.glade") 
builder.connect_signals(Handler()) 
window = builder.get_object("window1") 
window.connect("delete-event", Gtk.main_quit) 
window.show_all() 
Gtk.main()

Creeu un fitxer ui.glade i ompliu-lo amb aquest codi.

<?xml version="1.0" encoding="UTF-8"?> 
<!-- Generated with glade 3.16.1 --> 
<interface> 
  <requires lib="gtk+" version="3.10"/> 
  <object class="GtkWindow" id="window1"> 
    <property name="can_focus">False</property> 
    <property name="title" translatable="yes">My Program</property> 
    <property name="window_position">center</property> 
    <property name="icon_name">applications-utilities</property> 
    <property name="gravity">center</property> 
    <child> 
      <object class="GtkBox" id="box1"> 
        <property name="visible">True</property> 
        <property name="can_focus">False</property> 
        <property name="margin_left">5</property> 
        <property name="margin_right">5</property> 
        <property name="margin_top">5</property> 
        <property name="margin_bottom">5</property> 
        <property name="orientation">vertical</property> 
        <property name="homogeneous">True</property> 
        <child> 
          <object class="GtkLabel" id="label1"> 
            <property name="visible">True</property> 
            <property name="can_focus">False</property> 
            <property name="label" translatable="yes">Welcome to this Test Program !</property> 
          </object> 
          <packing> 
            <property name="expand">False</property> 
            <property name="fill">True</property> 
            <property name="position">0</property> 
          </packing> 
        </child> 
        <child> 
          <object class="GtkButton" id="button2"> 
            <property name="label" translatable="yes">Click on me to open the Terminal</property> 
            <property name="visible">True</property> 
            <property name="can_focus">True</property> 
            <property name="receives_default">True</property> 
            <signal name="clicked" handler="openterminal" swapped="no"/> 
          </object> 
          <packing> 
            <property name="expand">False</property> 
            <property name="fill">True</property> 
            <property name="position">1</property> 
          </packing> 
        </child> 
        <child> 
          <object class="GtkButton" id="button3"> 
            <property name="label">gtk-preferences</property> 
            <property name="visible">True</property> 
            <property name="can_focus">True</property> 
            <property name="receives_default">True</property> 
            <property name="use_stock">True</property> 
          </object> 
          <packing> 
            <property name="expand">False</property> 
            <property name="fill">True</property> 
            <property name="position">2</property> 
          </packing> 
        </child> 
        <child> 
          <object class="GtkButton" id="button4"> 
            <property name="label">gtk-about</property> 
            <property name="visible">True</property> 
            <property name="can_focus">True</property> 
            <property name="receives_default">True</property> 
            <property name="use_stock">True</property> 
          </object> 
          <packing> 
            <property name="expand">False</property> 
            <property name="fill">True</property> 
            <property name="position">3</property> 
          </packing> 
        </child> 
        <child> 
          <object class="GtkButton" id="button1"> 
            <property name="label">gtk-close</property> 
            <property name="visible">True</property> 
            <property name="can_focus">True</property> 
            <property name="receives_default">True</property> 
            <property name="use_stock">True</property> 
            <signal name="clicked" handler="closeprogram" swapped="no"/> 
          </object> 
          <packing> 
            <property name="expand">False</property> 
            <property name="fill">True</property> 
            <property name="position">4</property> 
          </packing> 
        </child> 
      </object> 
    </child> 
  </object> 
</interface>

No hi ha res de nou fins ara... Acabem de crear un fitxer Python i el seu fitxer d'interfície. Ara creeu un fitxer \setup.py a la mateixa carpeta i afegiu-hi el codi següent, cada línia s'explica als comentaris.

# Here we imported the 'setup' module which allows us to install Python scripts to the local system beside performing some other tasks, you can find the documentation here: https://docs.python.org/2/distutils/apiref.html 
from distutils.core import setup 

setup(name = "myprogram", # Name of the program. 
      version = "1.0", # Version of the program. 
      description = "An easy-to-use web interface to create & share pastes easily", # You don't need any help here. 
      author = "TecMint", # Nor here. 
      author_email = "[email ",# Nor here :D 
      url = "http://example.com", # If you have a website for you program.. put it here. 
      license='GPLv3', # The license of the program. 
      scripts=['myprogram'], # This is the name of the main Python script file, in our case it's "myprogram", it's the file that we added under the "myprogram" folder. 

# Here you can choose where do you want to install your files on the local system, the "myprogram" file will be automatically installed in its correct place later, so you have only to choose where do you want to install the optional files that you shape with the Python script 
      data_files = [ ("lib/myprogram", ["ui.glade"]), # This is going to install the "ui.glade" file under the /usr/lib/myprogram path. 
                     ("share/applications", ["myprogram.desktop"]) ] ) # And this is going to install the .desktop file under the /usr/share/applications folder, all the folder are automatically installed under the /usr folder in your root partition, you don't need to add "/usr/ to the path. 

Ara creeu un fitxer \myprogram.desktop a la mateixa carpeta i afegiu el codi següent, també s'explica als comentaris.

# This is the .desktop file, this file is the responsible file about showing your application in the applications menu in any desktop interface, it's important to add this file to your project, you can view more details about this file from here: https://developer.gnome.org/integration-guide/stable/desktop-files.html.en 
[Desktop Entry] 
# The default name of the program. 
Name=My Program 
# The name of the program in the Arabic language, this name will be used to display the application under the applications menu when the default language of the system is Arabic, use the languages codes to change the name for each language. 
Name[ar]=برنامجي 
# Description of the file. 
Comment=A simple test program developed by me. 
# Description of the file in Arabic. 
Comment[ar]=برنامج تجريبي بسيط تم تطويره بواسطتي. 
# The command that's going to be executed when the application is launched from the applications menu, you can enter the name of the Python script or the full path if you want like /usr/bin/myprogram 
Exec=myprogram 
# Do you want to run your program from the terminal? 
Terminal=false 
# Leave this like that. 
Type=Application 
# Enter the name of the icon you want to use for the application, you can enter a path for the icon as well like /usr/share/pixmaps/icon.png but make sure to include the icon.png file in your project folder first and in the setup.py file as well. Here we'll use the "system" icon for now. 
Icon=system 
# The category of the file, you can view the available categories from the freedesktop website.
Categories=GNOME;GTK;Utility; 
StartupNotify=false 

Gairebé hem acabat aquí. Només hem de crear alguns fitxers petits a la carpeta \debian” per tal de proporcionar informació sobre el nostre paquet per al \dpkg” sistema.

Obriu la carpeta \debian i creeu els fitxers següents.

control
compat
changelog
rules

control: aquest fitxer proporciona la informació bàsica sobre el paquet Debian; per a més detalls, visiteu Camps de control de paquets Debian.

Source: myprogram
Maintainer: My Name <[email > 
Section: utils 
Priority: optional 
Standards-Version: 3.9.2 
Build-Depends: debhelper (>= 9), python2.7 

Package: myprogram 
Architecture: all 
Depends: python-gi 
Description: My Program 
Here you can add a short description about your program.

compat: aquest és només un fitxer important per al sistema dpkg, només inclou el número màgic 9, deixeu-ho així.

9

Registre de canvis: aquí podreu afegir els canvis que feu al vostre programa; per obtenir més informació, visiteu Font del registre de canvis del paquet Debian.

myprogram (1.0) trusty; urgency=medium 

  * Add the new features here. 
  * Continue adding new changes here. 
  * And here. 

 -- My Name Here <[email >  Sat, 27 Dec 2014 21:36:33 +0200

regles: aquest fitxer és responsable d'executar el procés d'instal·lació a la màquina local per instal·lar el paquet, podeu veure més informació
sobre aquest fitxer des d'aquí: Debian Package Default Rules.

Tot i que no necessitareu res més per al vostre programa Python.

#!/usr/bin/make -f 
# This file is responsible about running the installation process on the local machine to install the package, you can view more information about this file from here: https://www.debian.org/doc/manuals/maint-guide/dreq.en.html#defaultrules Though you won't need anything more for your Python program. 
%: 
    dh [email  
override_dh_auto_install: 
    python setup.py install --root=debian/myprogram --install-layout=deb --install-scripts=/usr/bin/ # This is going to run the setup.py file to install the program as a Python script on the system, it's also going to install the "myprogram" script under /usr/bin/ using the --install-scripts option, DON'T FORGET TO REPLACE "myprogram" WITH YOUR PROGRAM NAME. 
override_dh_auto_build:

Ara hem creat tots els fitxers necessaris per al nostre programa amb èxit, ara comencem a empaquetar-lo. Primer, assegureu-vos que heu instal·lat algunes dependències per al procés de creació abans de començar.

$ sudo apt-get update
$ sudo apt-get install devscripts

Ara imagineu que la carpeta \myprogram és a la vostra carpeta d'inici (/home/user/myprogram) per empaquetar-la com a paquet Debian, executeu les ordres següents .

$ cd /home/user/myprogram
$ debuild -us -uc
[email :~/Projects/myprogram$
debuild -us -uc dpkg-buildpackage -rfakeroot -D -us -uc
dpkg-buildpackage: source package myprogram
dpkg-buildpackage: source version 1.0
dpkg-buildpackage: source distribution trusty
dpkg-buildpackage: source changed by My Name Here
<[email >
dpkg-source --before-build myprogram
dpkg-buildpackage: host architecture i386
fakeroot debian/rules clean
dh clean
dh_testdir
dh_auto_clean
....
.....
Finished running lintian.

I ja està ! El vostre paquet Debian s'ha creat correctament:

Per instal·lar-lo a qualsevol distribució basada en Debian, executeu.

$ sudo dpkg -i myprogram_1.0_all.deb

No oblideu substituir el fitxer anterior pel nom del paquet. Ara, després d'instal·lar el paquet, podeu executar el programa des del menú d'aplicacions.

I funcionarà..

Aquí acaba la 4a part de la nostra sèrie sobre PyGObject. A la lliçó següent explicarem com localitzar l'aplicació PyGObject fàcilment, fins aleshores estigueu atents...