PyGObject-sovellusten ja -ohjelmien paketointi ".deb" -pakettina Linux-työpöydälle - osa 4
Jatkamme PyGObject -ohjelmasarjaa kanssasi Linux-työpöydällä. Sarjan neljännessä osassa kerromme, kuinka pakataan ohjelmat ja sovellukset, jotka olemme luoneet Linux-työpöytä, joka käyttää PyGObjectia Debian-pakettina.
Debian-paketit ( .deb ) ovat eniten käytetty muoto ohjelmien asentamiseen Linuxiin, .deb -paketteja käsittelevä "dpkg " kaikkien Debian-pohjaisten Linux-jakelujen, kuten Ubuntu ja Linux Mint, oletusarvo. Siksi selitämme vain, miten ohjelmamme pakataan Debianille.
Luo Debian-paketti PyGObject-sovelluksistasi
Ensinnäkin sinulla on oltava perustiedot Debian-pakettien luomisesta, tämä seuraava opas auttaa sinua paljon.
- Johdatus Debianin pakkausmateriaaleihin
Lyhyesti sanottuna, jos sinulla on projekti, jonka nimi on oma ohjelma , sen on sisällettävä seuraavat tiedostot ja kansiot, jotta voit pakata sen.
- debian (kansio): Tämä kansio sisältää kaikki tiedot Debian-paketista jaettuna moniin alitiedostoihin.
- po (kansio): po-kansio sisältää ohjelman käännöstiedostot (selitämme sen osassa 5).
- myprogram (Tiedosto): Tämä on PyGObjectilla luotu Python-tiedosto, se on projektin päätiedosto.
- ui.glade (Tiedosto): Graafinen käyttöliittymätiedosto. Jos luot sovelluksen käyttöliittymän Gladen avulla, sinun on sisällytettävä tämä tiedosto
projektiisi. - bMyprogram.desktop (tiedosto): Tämä on tiedosto, joka vastaa sovelluksen näyttämisestä sovellusvalikossa.
- setup.py (tiedosto): Tämä tiedosto on vastuussa minkä tahansa Python-ohjelman asentamisesta paikalliseen järjestelmään, se on erittäin tärkeä missä tahansa Python-ohjelmassa, sillä on myös monia muita käyttötapoja.
Tietenkin .. On monia muita tiedostoja ja kansioita, jotka voit sisällyttää projektiisi (itse asiassa voit sisällyttää mitä tahansa haluamaasi), mutta ne ovat perustietoja.
Aloitetaan nyt projektin pakkaaminen. Luo uusi kansio nimeltä oma ohjelma , luo tiedosto nimeltä oma ohjelma ja lisää siihen seuraava koodi.
#!/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()
Luo ui.glade -tiedosto ja täytä se tällä koodilla.
<?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>
Ei ole mitään uutta tähän asti. Olemme juuri luoneet Python-tiedoston ja sen käyttöliittymätiedoston. Luo nyt setup.py -tiedosto samaan kansioon ja lisää siihen seuraava koodi, jokainen rivi selitetään kommenteissa.
# 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.
Luo nyt myprogram.desktop -tiedosto samaan kansioon ja lisää seuraava koodi, joka selitetään myös kommenteissa.
# 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
Olemme melkein täällä täällä .. Meidän on vain luotava pieniä tiedostoja " debian " -kansioon, jotta voimme antaa tietoja paketistamme " dpkg " järjestelmään.
Avaa debian -kansio ja luo seuraavat tiedostot.
control compat changelog rules
hallinta : Tämä tiedosto sisältää perustiedot Debian-paketista. Lisätietoja on Debianin paketin hallintakentissä.
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.
yhteensopiva : Tämä on vain tärkeä tiedosto dpkg-järjestelmälle, se sisältää vain maagisen 9-luvun, jätä se tuollaiseksi.
9
muutosloki : Täällä voit lisätä muutokset, jotka teet ohjelmasi. Lisätietoja saat käymällä Debian-paketin muutoslokin lähteessä.
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
säännöt : Tämä tiedosto on vastuussa asennusprosessin suorittamisesta paikallisella koneella paketin asentamiseksi. Voit tarkastella lisätietoja
tästä tiedostosta täältä: Debian-paketin oletussäännöt.
Vaikka et tarvitse mitään muuta Python-ohjelmallesi.
#!/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:
Nyt olemme luoneet kaikki tarvittavat tiedostot ohjelmallemme onnistuneesti, nyt aloitetaan pakkaus. Varmista ensin, että olet asentanut joitain riippuvuuksia rakennusprosessille ennen aloittamista.
$ sudo apt-get update $ sudo apt-get install devscripts
Kuvittele nyt, että kansio myprogram on kotikansiossasi (/home/user/myprogram ) pakataksesi sen Debian-pakettina, suorita seuraavat komennot.
$ 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.
Ja siinä se! Debian-pakettisi luotiin onnistuneesti:
Asenna se mihin tahansa Debian-pohjaiseen jakeluun suorittamalla.
$ sudo dpkg -i myprogram_1.0_all.deb
Älä unohda korvata yllä olevaa tiedostoa paketin nimellä. Nyt kun olet asentanut paketin, voit suorittaa ohjelman sovellusvalikosta.
Ja se toimii ..
Tässä loppuu PyGObjectia käsittelevän sarjan 4. osa. Seuraavassa oppitunnissa selitämme, kuinka PyGObject-sovellus lokalisoidaan helposti, kunnes pysymme sen tuntemassa ...