# Hello World(Python)

Susanna Huhtanen
ihmis.suski@gmail.com 2012
Tiffany Antopolski
tiffany.antopolski@gmail.com
기본 "hello, world" 프로그램
조성호
shcho@gnome.org 2017-2019.

# Hello World 프로그램의 tar.xz 파일을 빌드하고, 설치하고, 만들기

          이 지침서에서는 다음 방법을 보여줍니다:

            파이썬과 GTK+를 사용한 작은 "Hello, World" 프로그램을 만듭니다
            .desktop 파일 만들기
            빌드 시스템 구성 방법

# 프로그램 만들기

## 가져올 라이브러리

from gi.repository import Gtk import sys

우리가 작성한 스크립트가 그놈에서 동작하게 하려면, 그놈 라이브러리를 GObject 인트로스펙션으로 가져와야합니다. 여기서 우리는 언어 바인딩과 그놈 프로그램을 만들 때 그래픽 위젯이 들어있는 GTK+ 라이브러리를 임포팅합니다.

## 프로그램 메인 창 만들기

class MyWindow(Gtk.ApplicationWindow):

# constructor for a Gtk.ApplicationWindow def __init__(self, app): Gtk.Window.__init__(self, title="Hello World!", application=app) self.set_default_size(200, 100)

class MyApplication(Gtk.Application): def __init__(self): Gtk.Application.__init__(self)

def do_activate(self): win = MyWindow(self) win.show_all()

def do_startup(self): Gtk.Application.do_startup(self)

Gtk.Application은 GTK+를 초기화합니다. 또한 창을 만들 때 자동으로 붙인 x 단추를 "destroy" 시그널에 연결합니다.

첫 창 만들기를 시작할 수 있습니다. MyWindow 클래스를 만들고 Gtk.ApplicationWindow를 할당하겠습니다.

창에 title 속성을 설정해야합니다. 제목은 원하는대로 지을 수 있습니다. 안전한 방편으로, UTF-8 인코딩으로 작성하시는게 좋습니다.

이제 제목과 동작하는 "닫기" 단추가 붙은 창을 만들었습니다. 이제 실제 "Hello World" 문구를 찍어보겠습니다.

## 창 레이블

# Add a label widget to your window

# create a label label = Gtk.Label()

# set the text of the label label.set_text("Hello GNOME!")

# add the label to the window self.add(label)

텍스트 레이블은 가져온 GTK+ 라이브러리에 들어있어 우리가 활용할 수 있는 GTK+ 위젯 중 하나입니다. 이 위젯을 사용하려, label 변수를 만들고, 계속 표시해 둘 텍스트를 설정하겠습니다. 최종적으로, 프로그램을 만들고 실행합니다:

#run the application

app = MyApplication() exit_status = app.run(sys.argv) sys.exit(exit_status)

Gtk.ApplicationWindow는 한번에 위젯 하나만 가질 수 있습니다. 프로그램을 더 정교하게 만들려면 Gtk.Grid 같은 홀더 위젯을 창 안에 만들어 넣고 그 안에 위젯을 추가해야합니다.

## hello-world.py

완전한 파일 내용:

from gi.repository import Gtk import sys

class MyWindow(Gtk.ApplicationWindow): # constructor for a Gtk.ApplicationWindow

def __init__(self, app): Gtk.Window.__init__(self, title="Welcome to GNOME", application=app) self.set_default_size(200, 100)

# create a label label = Gtk.Label() # set the text of the label label.set_text("Hello GNOME!") # add the label to the window self.add(label)

class MyApplication(Gtk.Application):

def __init__(self): Gtk.Application.__init__(self)

def do_activate(self): win = MyWindow(self) win.show_all()

def do_startup(self): Gtk.Application.do_startup(self)

app = MyApplication() exit_status = app.run(sys.argv) sys.exit(exit_status)

## 터미널에서 프로그램 실행

이 프로그램을 실행하려면 우선 hello-world.py로 저장하십시오. 그 다음 터미널을 여시고 프로그램을 저장한 폴더로 이동하신 다음 실행하십시오:

    $ python hello-world.py

# .desktop.in 파일

터미널에서의 프로그램 실행은 프로그램을 처음 만드는 단계에서 상당히 유용합니다. 그놈 3에서 완벽하게 프로그램 통합하여 동작할 수 있게 하려면 데스크톱 실행 아이콘이 필요합니다. 이 아이콘을 만들려면 .desktop 파일을 만들어야합니다. 파일은 프로그램 이름, 사용 아이콘, 다양한 통합 부분을 서술합니다. .desktop 파일에 대한 더 자세한 관점은 여기에 있습니다. .desktop.in 파일로 .desktop 파일을 만듭니다.

예제에서는 `.desktop.in` 파일에서 최소한 필요한 내용을 보여줍니다.

[Desktop Entry] Version=1.0 Encoding=UTF-8 Name=Hello World Comment=Say Hello Exec=@prefix@/bin/hello-world Icon=application-default-icon Terminal=false Type=Application StartupNotify=true Categories=GNOME;GTK;Utility;

이제 `.desktop.in` 파일 부분으로 들어가보겠습니다.

## Name

프로그램 이름입니다.

## Comment

프로그램의 간단한 설명입니다.

## Exec

메뉴에서 프로그램을 선택했을 때 실행할 명령을 지정합니다. 이 예제에서는 hello-world 파일을 어디서 찾는지 알려주며 파일을 다루는 방식은 나머지 부분에서 다룹니다.

## Terminal

Exec 키의 명령을 터미널 창에서 실행할 지 여부를 지정합니다.

프로그램을 적당한 분류에 넣으려면 Categories 줄에 필요한 분류 이름을 추가해야합니다. 다른 분류에 대한 자세한 정보는 메뉴 명세에 있습니다.

In this example we use an existing icon. For a custom icon you need to have a .svg file of your icon, stored in /usr/share/icons/hicolor/scalable/apps. Write the name of your icon file to the .desktop.in file, on line 7. More information on icons in: Installing Icons for Themes and on freedesktop.org: Specifications/icon-theme-spec.

# 빌드 시스템

그놈 3의 일부 프로그램을 만들려면 autotools의 도움을 받아 설치해야합니다. autotools 빌드는 필요한 모든 파일을 모든 올바른 경로에 설치합니다.

진행하려면 다음 파일이 필요합니다:

## autogen.sh

#!/bin/sh

set -e

test -n "$srcdir" || srcdir=`dirname "$0"` test -n "$srcdir" || srcdir=.

olddir=`pwd` cd "$srcdir"

# This will run autoconf, automake, etc. for us autoreconf --force --install

cd "$olddir"

if test -z "$NOCONFIGURE"; then "$srcdir"/configure "$@" fi

autogen.sh 파일을 준비했고 저장하고 나면, 다음을 실행하십시오:

    $ chmod +x autogen.sh

## Makefile.am

# The actual runnable program is set to the SCRIPTS primitive. # # Prefix bin_ tells where to copy this bin_SCRIPTS = hello-world.py # # List of files to be distributed EXTRA_DIST= \ $(bin_SCRIPTS) # # # The desktop files desktopdir = $(datadir)/applications desktop_DATA = \ hello-world.desktop

## configure.ac

# This file is processed by autoconf to create a configure script AC_INIT([Hello World], 1.0) AM_INIT_AUTOMAKE([1.10 no-define foreign dist-xz no-dist-gzip]) AC_CONFIG_FILES([Makefile hello-world.desktop]) AC_OUTPUT

## README

사용자가 우선 읽어야 할 내용입니다. 이 파일은 비워둘 수 있습니다.

올바른 내용을 넣고 권한을 설정한 hello-world, hello-world.desktop.in, Makefile.am, configure.ac, autogen.sh 파일을 갖췄다면, README 파일에 다음 내용을 넣을 수 있습니다:

To build and install this program:

./autogen.sh --prefix=/home/your_username/.local make install

------------- Running the first line above creates the following files:

aclocal.m4 autom4te.cache config.log config.status configure hello-world.desktop install-sh missing Makefile.in Makefile

Running "make install", installs the application in /home/your_username/.local/bin and installs the hello-world.desktop file in /home/your_username/.local/share/applications

You can now run the application by typing "Hello World" in the Overview.

---------------- To uninstall, type:

make uninstall

---------------- To create a tarball type:

make distcheck

This will create hello-world-1.0.tar.xz