From 23a520237b38ce80a4ac10cc3eb53cfecdeab0d3 Mon Sep 17 00:00:00 2001 From: Gerald Combs Date: Wed, 4 Jan 2012 22:13:01 +0000 Subject: Add initial support for Qt along with a "ui" subdirectory. svn path=/trunk/; revision=40378 --- doc/README.qt | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 doc/README.qt (limited to 'doc') diff --git a/doc/README.qt b/doc/README.qt new file mode 100644 index 0000000000..de486f860c --- /dev/null +++ b/doc/README.qt @@ -0,0 +1,41 @@ +0. Abstract + +Wireshark's user interface is showing its age. While GTK+ is wonderful on Linux and BSD its low-tier status on Windows and even-lower-tier status on OS X makes it hard to deliver a good product to users on those platforms. + +The Qt port is an attempt at an updated UI which will better serve our users and let us add features more easily. + + +1. Getting up and running + +The Qt interface for Wireshark has been compiled and tested on Mac OS X 10.6 (XCode gcc), Windows 7 x86 (Visual C++ 2010), and Ubuntu 10.04 (gcc). Compilation via Qt Creator has been tested but command-line compilation using QMake and make or nmake should work. + +The ui/qt directory is loosely coupled with the rest of the codebase. The main Wireshark sources must be built beforehand using CMake on Linux and OS X and nmake on Windows. Autotools + QMake is a basket full of crazy that hasn't yet been sorted and folded. + +1.1 Prerequisites + +Before compiling you need the Qt SDK and Qt Creator. + +1.1.1 OS X + +Download the latest Qt SDK (currently 1.1.4) and install it. Build the top-level directory using CMake. + +1.1.2 Windows + +The default Qt SDK libraries are built using MinGW, which isn't supported for Wireshark. Instead of downloading the Qt SDK all-in-one package, download the Qt Libraries package that matches your compiler (VS 2008 or VS 2010) and Qt Creator for Windows. + +For the time being you must set win32:WIRESHARK_LIB_DIR in QtShark.pro to match the global build environment. The default location is c:/wireshark-win32-libs (yes, that's a forward slash). + +Before compiling select "Projects" in the left toolbar, select "Build Settings" and do the following: + +- In "Edit build configuration" make sure the "Release" build is selected. ("Debug" currently crashes.) +- Make sure "Qt version" matches your version of Visual Studio. +- Make sure "Tool chain" matches your Visual C++ version. + +1.1.3 Linux + +Install the Qt libraries and Qt Creator via your package manager or from http://qt.nokia.com/downloads/. On Debian and Ubuntu the "qt-sdk" meta-package should provide everything you need. Build the top-level directory using CMake. + + +2. Going forward + +DO NOT simply port things over. Every feature, window, and element should be re-thought. For example, should the user have to navigate two dialogs to get HTTP request statistics? -- cgit v1.2.3