1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
|
/***
Copyright (C) 2011-2013 Maxwell Barvian <maxwell@elementaryos.org>
This program or library is free software; you can redistribute it
and/or modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 3 of the License, or (at your option) any later version.
This library 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
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General
Public License along with this library; if not, write to the
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301 USA.
***/
using Gtk;
using Granite.Services;
using Granite.Widgets;
namespace Granite {
/**
* Global deprecated object..
*/
[Deprecated (since = "granite-0.1")]
public static Granite.Application app;
/**
* This is the base class for all Granite-based apps. It has methods that help
* to create a great deal of an app's functionality.
*/
public abstract class Application : Gtk.Application {
public string build_data_dir;
public string build_pkg_data_dir;
public string build_release_name;
public string build_version;
public string build_version_info;
/**
* The user facing name of the application. This name is used
* throughout the application and should be capitalized correctly.
*/
public string program_name;
/**
* The compiled binary name, which must match the CMake exec name.
* This is used to launch the application from a launcher or the
* command line.
*/
public string exec_name;
/**
* Years that the copyright extends to. Usually from the start
* of the project to the most recent modification to it.
*/
public string app_copyright;
public string app_years;
/**
* Icon to be associated with the application.
*
* This is either the name of an icon shipped by the icon theme,
* or the name of an icon shipped with the app (for custom icons).
* The name should not include the full path or file extension.
* WRONG: /usr/share/icons/myicon.png RIGHT: myicon
*/
public string app_icon;
/**
* The launcher to be associated with this application.
*
* This should be the name of a file in /usr/share/applications/.
* See [[http://standards.freedesktop.org/desktop-entry-spec/latest/]]
* for more information.
*/
public string app_launcher;
/**
* Main website or homepage for the application.
*
* If the application has no homepage, one should be created on
* launchpad.net.
*/
public string main_url;
/**
* A link to the software's public bug tracker.
*
* If the application does not have a bug tracker, one should be
* created on launchpad.net.
*/
public string bug_url;
/**
* Link to question and answer site or support forum for the app.
*
* Launchpad offers a QA service if one is needed.
*/
public string help_url;
/**
* Link to where users can translate the application.
*
* Launchad offers a translation service if one is necessary.
*/
public string translate_url;
/**
* Full names of the application authors for the about dialog.
*/
public string[] about_authors = {};
/**
* Full names of documenters of the app for the about dialog.
*/
public string[] about_documenters = {};
/**
* Names of the designers of the application's user interface.
*/
public string[] about_artists = {};
public string about_comments;
/**
* Names of the translators of the application.
*/
public string about_translators;
/**
* The copyright license that the work is distributed under.
*/
public string about_license;
public License about_license_type;
/**
* This creates a new Application class
*/
public Application () {
#if LINUX
prctl (15, exec_name, 0, 0, 0);
#elif DRAGON_FLY || FREE_BSD || NET_BSD || OPEN_BSD
setproctitle (exec_name);
#endif
Environment.set_prgname (exec_name);
Logger.initialize (program_name);
Logger.DisplayLevel = LogLevel.INFO;
message ("%s version: %s", program_name, build_version);
var un = Posix.utsname ();
message ("Kernel version: %s", (string) un.release);
Logger.DisplayLevel = LogLevel.WARN;
Intl.bindtextdomain (exec_name, build_data_dir + "/locale");
add_actions ();
// Deprecated
Granite.app = this;
}
#if LINUX
[CCode (cheader_filename = "sys/prctl.h", cname = "prctl")]
protected extern static int prctl (int option, string arg2, ulong arg3, ulong arg4, ulong arg5);
#elif DRAGON_FLY || FREE_BSD
[CCode (cheader_filename = "unistd.h", cname = "setproctitle")]
protected extern static void setproctitle (string fmt, ...);
#elif NET_BSD || OPEN_BSD
[CCode (cheader_filename = "stdlib.h", cname = "setproctitle")]
protected extern static void setproctitle (string fmt, ...);
#endif
/**
* This method runs the application
*
* @param args array of arguments
*/
public new int run (string[] args) {
// parse commandline options
var context = new OptionContext ("");
context.add_main_entries (options, null);
context.add_group (Gtk.get_option_group (false));
try {
context.parse (ref args);
} catch { }
set_options ();
if (ABOUT) {
Gtk.init (ref args);
handle_about_parameter ();
return Posix.EXIT_SUCCESS;
}
return base.run (args);
}
protected static bool DEBUG = false;
protected static bool ABOUT = false;
protected const OptionEntry[] options = {
{ "debug", 'd', 0, OptionArg.NONE, out DEBUG, "Enable debug logging", null },
{ "about", 'a', 0, OptionArg.NONE, out ABOUT, "Show About dialog", null },
{ null }
};
protected virtual void set_options () {
if (DEBUG)
Logger.DisplayLevel = LogLevel.DEBUG;
}
/**
* This methods creates a new App Menu
*
* @param menu the menu to create the App Menu for
*
* @return app_menu
*/
public AppMenu create_appmenu (Gtk.Menu menu) {
AppMenu app_menu = new AppMenu.with_app (this, menu);
app_menu.show_about.connect (show_about);
return app_menu;
}
protected Granite.Widgets.AboutDialog about_dlg;
/**
* This method shows the about dialog of this app.
*
* @param parent This widget is the window that is calling the about page being created.
*/
public virtual void show_about (Gtk.Widget parent) {
assert (parent is Gtk.Window);
var developers_string = _("Developers");
Granite.Widgets.show_about_dialog ((Gtk.Window) parent,
"program_name", program_name,
"version", build_version,
"logo_icon_name", app_icon,
"comments", about_comments,
"copyright", "%s %s %s".printf (app_years, program_name, developers_string),
"website", main_url,
"website_label", _("Website"),
"authors", about_authors,
"documenters", about_documenters,
"artists", about_artists,
"translator_credits", about_translators,
"license", about_license,
"license_type", about_license_type,
"help", help_url,
"translate", translate_url,
"bug", bug_url);
}
/* Allows reusing the About dialog */
private Gtk.Window about_dialog_parent = null;
private void add_actions () {
/* Actions are always executed in the primary instance, provided
that the application was registered.
Take advantage of this by showing the About dialog using the
main instance, saving memory. */
var show_about_action = new SimpleAction ("show-about-dialog", null);
show_about_action.activate.connect (() => {
hold ();
debug ("The show-about-dialog action was activated");
if (this.about_dialog_parent == null)
this.about_dialog_parent = new Gtk.Window ();
show_about (this.about_dialog_parent);
release ();
});
add_action (show_about_action);
}
private void handle_about_parameter () {
try {
register ();
} catch (Error error) {
warning ("Couldn't register application: %s", error.message);
}
activate_action ("show-about-dialog", null);
if (!this.is_remote) {
/* This means that the primary instance was created by running
"app --about".
Manually set up exit conditions and run the main loop of the
application.
This is needed to prevent weird stuff from happening if the
actual application is opened while this is running. */
Gtk.Widget about_dialog = this.about_dialog_parent.get_data ("gtk-about-dialog");
about_dialog.hide.connect (() => {
if (get_windows () == null)
Gtk.main_quit ();
});
window_removed.connect (() => {
if (get_windows () == null)
Gtk.main_quit ();
});
Gtk.main ();
}
}
}
}
|