MacOS application without menu bar

From Qt Wiki
Revision as of 09:38, 24 February 2015 by Maintenance script (talk | contribs)
Jump to navigation Jump to search


Sometimes you want to create an application that runs in the background and should not have a menu bar or appear in the OS X dock. There is no standard way in Qt itself to tell the application so (i.e. no setter on the QApplication object for example).

Instead, one has to tell the OS X application launcher via the application bundle configuration in Info.plist. The file is located in YourFancyApplication.app/Contents/Info.plist. It is added to the bundle by Qt automatically and contains your application's name and some other information which is filled in by qmake generated build steps. In order to remove the entire menu bar and dock functionality add to this file:

<br />&lt;key&amp;gt;LSUIElement&amp;lt;/key&amp;gt;<br />&lt;string&amp;gt;1&amp;lt;/string&amp;gt;<br />

See Apple's doc about "LSUIElement&quot;:http://developer.apple.com/library/ios/documentation/general/Reference/InfoPlistKeyReference/Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/20001431-108256 for more info.

If you edit this file manually it may be overwritten by the build system &#40;at latest if you call "make distclean&quot;&#41;. Fortunatelly, qmake provides a configuration option to point to a custom Info.plist file, which you can pre-modify with the above snippet. Just add to your .pro file:

<br />QMAKE_INFO_PLIST = /path/to/your/custom/Info.plist<br />

See the docs about "QMAKE_INFO_PLIST&quot;:http://doc.qt.nokia.com/4.7/qmake-variable-reference.html#qmake-info-plist for some more details.

Caveat: If you modify the Info.plist template, it is not automatically replaced in the bundle as of this writing (2011-10-10, Qt version 4.7.2)! To trigger this, you will have to remove the application bundle directory.

To start easy, just grab the default file from /path/to/your/qt/installation/mkspecs/default/Info.plist.app and add the snippet above. This looks like this then:

<br />&amp;lt;?xml version=&quot;1.0&amp;quot; encoding=&quot;UTF-8&amp;quot;?&amp;gt;<br />&lt;[[Image:DOCTYPE plist SYSTEM &quot;file://localhost/System/Library/DTDs/PropertyList.dtd&quot;&gt;
&lt;plist version=&quot;0.9&quot;&gt;
&lt;dict&gt;
    &amp;lt;|]] start of standard entries &amp;gt;<br /> &lt;key&amp;gt;CFBundleIconFile&amp;lt;/key&amp;gt;<br /> &lt;string&amp;gt;&amp;#x40;ICON&amp;amp;#x40;&lt;/string&amp;gt;<br /> &lt;key&amp;gt;CFBundlePackageType&amp;lt;/key&amp;gt;<br /> &lt;string&amp;gt;APPL&amp;lt;/string&amp;gt;<br /> &lt;key&amp;gt;CFBundleGetInfoString&amp;lt;/key&amp;gt;<br /> &lt;string&amp;gt;Created by Qt/QMake&amp;lt;/string&amp;gt;<br /> &lt;key&amp;gt;CFBundleSignature&amp;lt;/key&amp;gt;<br /> &lt;string&amp;gt;&amp;#x40;TYPEINFO&amp;amp;#x40;&lt;/string&amp;gt;<br /> &lt;key&amp;gt;CFBundleExecutable&amp;lt;/key&amp;gt;<br /> &lt;string&amp;gt;&amp;#x40;EXECUTABLE&amp;amp;#x40;&lt;/string&amp;gt;<br /> &lt;key&amp;gt;CFBundleIdentifier&amp;lt;/key&amp;gt;<br /> &lt;string&amp;gt;com.yourcompany.&amp;#x40;EXECUTABLE&amp;amp;#x40;&lt;/string&amp;gt;<br /> &lt;key&amp;gt;NOTE&amp;lt;/key&amp;gt;<br /> &lt;string&amp;gt;This file was generated by Qt/QMake.&lt;/string&amp;gt;<br /> &amp;lt;! start of customized entries &amp;gt;<br /> &lt;key&amp;gt;LSUIElement&amp;lt;/key&amp;gt;<br /> &lt;string&amp;gt;1&amp;lt;/string&amp;gt;<br />&lt;/dict&amp;gt;<br />&lt;/plist&amp;gt;<br />

You can leave the &#x40;ICON&amp;#x40;, &#x40;TYPEINFO&amp;#x40; and &#x40;EXECUTABLE&amp;#x40; placeholders as is, they are replaced with actual values by qmake/make once the Info.plist template is copied to your application bundle.