Development/Tutorials/Desktop File: Difference between revisions

    From KDE TechBase
    (Created page with "{{Template:I18n/Language Navigation Bar|Development/Tutorials/Desktop File}} {{TutorialBrowser| series=Basics| name=Desktop File| pre=[[Development/Tutorials/Session_Manageme...")
     
    (what does this have to do with my project)
    Line 33: Line 33:


    Take a look at [http://standards.freedesktop.org/desktop-entry-spec/latest/ the .desktop Free Desktop Spec] to find our more about the key/value pairs above. It's important to pick a good set of Categories, see the spec for a list of valid values.
    Take a look at [http://standards.freedesktop.org/desktop-entry-spec/latest/ the .desktop Free Desktop Spec] to find our more about the key/value pairs above. It's important to pick a good set of Categories, see the spec for a list of valid values.
    == Your project ==
    In your project you need to take care the .desktop file is distributed to the appropriate place.
    In case you are working on a qmake based project, add the following to your .pro file:
    '''target.path = /usr/local/bin'''
    desktop.path = /usr/share/applications
    desktop.files += your-app.desktop
    '''INSTALLS += target''' desktop
    Note that the bold strings above should be in your project anyway.


    [[Category:Programming]]
    [[Category:Programming]]
    [[Category:Tutorial]]
    [[Category:Tutorial]]
    [[Category:FAQs]]
    [[Category:FAQs]]

    Revision as of 16:18, 9 September 2011


    Development/Tutorials/Desktop File


    Desktop File
    Tutorial Series   Basics
    Previous   Session Management
    What's Next  
    Further Reading   the .desktop Free Desktop Spec;

    Desktop File

    In order for your application to show up in menus and/or to be automatically associated with mime types in file browsers, you need to provide a .desktop file like follows:

    [Desktop Entry]
    Type=Application
    Exec=your-app %u
    MimeType=application/x-your-mime-type;
    Icon=some-icon
    X-DocPath=yourapp/index.html
    Terminal=false
    Name=Your App
    GenericName=Some Generic Name
    Comment=Short Description Of Your App
    Categories=Qt;KDE;
    

    Take a look at the .desktop Free Desktop Spec to find our more about the key/value pairs above. It's important to pick a good set of Categories, see the spec for a list of valid values.

    Your project

    In your project you need to take care the .desktop file is distributed to the appropriate place. In case you are working on a qmake based project, add the following to your .pro file:

    target.path = /usr/local/bin
    desktop.path = /usr/share/applications
    desktop.files += your-app.desktop
    
    INSTALLS += target desktop
    

    Note that the bold strings above should be in your project anyway.