„PyGObject“ programų ir programų paketas kaip „.deb“ paketas, skirtas „Linux“ darbalaukiui – 4 dalis


Tęsiame PyGObject programavimo seriją su jumis „Linux“ darbalaukyje, 4-oje serijos dalyje paaiškinsime, kaip supakuoti programas ir programas, kurias sukūrėme „Linux“ darbalaukis, naudojant „PyGObject“ kaip „Debian“ paketą.

„Debian“ paketai (.deb) yra dažniausiai naudojamas formatas programoms diegti „Linux“, o „dpkg “ sistema, kuri dirba su .deb paketais, yra numatytasis visuose „Debian“ pagrindu veikiančiuose „Linux“ paskirstymuose, pvz., „Ubuntu“ ir „Linux Mint“. Štai kodėl mes tik paaiškinsime, kaip supakuoti savo programas Debian'ui.

Sukurkite „Debian“ paketą iš savo „PyGObject“ programų

Pirma, jūs turėtumėte turėti tam tikrų pagrindinių žinių apie Debian paketų kūrimą, šis vadovas jums labai padės.

  1. Įvadas į Debian Packaging

Trumpai tariant, jei turite projektą „mano programa“, jame turi būti šie failai ir aplankai, kad galėtumėte jį supakuoti.

  1. debian (aplankas): šiame aplanke yra visa informacija apie Debian paketą, suskirstytą į daugybę antrinių failų.
  2. po (aplankas): po aplanke yra programos vertimo failai (tai paaiškinsime 5 dalyje).
  3. mano programa (failas): tai Python failas, kurį sukūrėme naudodami PyGObject, tai pagrindinis projekto failas.
  4. ui.glade (Failas): grafinės vartotojo sąsajos failas. Jei sukūrėte programos sąsają naudodami Glade, turite įtraukti šį failą į
    jūsų projektas.
  5. bMyprogram.desktop (Failas): tai yra atsakingas failas už programos rodymą programų meniu.
  6. setup.py (Failas): šis failas yra atsakingas už bet kokios Python programos įdiegimą vietinėje sistemoje, jis labai svarbus bet kurioje Python programoje, jis taip pat turi daug kitų naudojimo būdų.

Žinoma.. Yra daug kitų failų ir aplankų, kuriuos galite įtraukti į savo projektą (iš tikrųjų galite įtraukti viską, ko norite), bet tai yra pagrindiniai.

Dabar pradėkime rengti projektą. Sukurkite naują aplanką pavadinimu „mano programa“, sukurkite failą „mano programa“ ir pridėkite prie jo šį kodą.

#!/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()

Sukurkite failą ui.glade ir užpildykite jį šiuo kodu.

<?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>

Iki šiol nieko naujo... Mes ką tik sukūrėme Python failą ir jo sąsajos failą. Dabar tame pačiame aplanke sukurkite failą „setup.py“ ir pridėkite prie jo šį kodą. Kiekviena eilutė paaiškinta komentaruose.

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. 

Dabar tame pačiame aplanke sukurkite failą „myprogram.desktop“ ir pridėkite šį kodą, taip pat paaiškinta komentaruose.

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 

Dabar jau beveik baigėme. Turime sukurti keletą nedidelių failų aplanke „debian“, kad pateiktume informaciją apie mūsų paketą „dpkg“ sistema.

Atidarykite aplanką debian ir sukurkite toliau nurodytus failus.

control
compat
changelog
rules

valdymas: Šiame faile pateikiama pagrindinė informacija apie Debian paketą. Norėdami gauti daugiau informacijos, apsilankykite Debian paketo valdymo laukuose.

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: tai tik svarbus failas dpkg sistemai, jame yra tik stebuklingas skaičius 9, palikite jį tokį.

9

pakeitimų žurnalas: čia galėsite įtraukti pakeitimus, kuriuos atliekate savo programoje. Norėdami gauti daugiau informacijos, apsilankykite „Debian“ paketo pakeitimų žurnalo šaltinyje.

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

taisyklės: šis failas yra atsakingas už diegimo proceso vykdymą vietiniame kompiuteryje, kad būtų įdiegtas paketas. Galite peržiūrėti daugiau informacijos
apie šį failą iš čia: Debian'o paketo numatytosios taisyklės.

Nors Python programai jums nieko daugiau nereikės.

#!/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 $@ 
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:

Dabar mes sėkmingai sukūrėme visus reikalingus failus mūsų programai, dabar pradėkime juos pakuoti. Pirma, prieš pradėdami įsitikinkite, kad įdiegėte kai kurias kūrimo proceso priklausomybes.

sudo apt-get update
sudo apt-get install devscripts

Dabar įsivaizduokite, kad aplankas „manoprograma“ yra jūsų namų aplanke (/home/user/myprogram), kad supakuotumėte jį kaip „Debian“ paketą, paleiskite šias komandas.

cd /home/user/myprogram
debuild -us -uc
Pavyzdžio išvestis
hanny@hanny-HP-Pavilion-15-Notebook-PC:~/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.

Štai ir viskas ! Jūsų Debian paketas buvo sėkmingai sukurtas:

Norėdami jį įdiegti bet kuriame Debian pagrindu veikiančiame paskirstyme, paleiskite.

sudo dpkg -i myprogram_1.0_all.deb

Nepamirškite anksčiau pateikto failo pakeisti paketo pavadinimu. Dabar, kai įdiegiate paketą, galite paleisti programą iš programų meniu.

Ir veiks..

Čia baigiasi 4-oji mūsų serijos apie PyGObject dalis. Kitoje pamokoje paaiškinsime, kaip lengvai lokalizuoti PyGObject taikomąją programą, kol jos laukiame...