Changeset 13071


Ignore:
Timestamp:
Nov 2, 2011, 11:13:02 PM (11 years ago)
Author:
livings124
Message:

#4611 Update Growl framework to 1.3

Location:
trunk/macosx/Growl.framework/Versions/A
Files:
2 added
1 deleted
5 edited

Legend:

Unmodified
Added
Removed
  • trunk/macosx/Growl.framework/Versions/A/Headers/Growl.h

    r10123 r13071  
    1 #include "GrowlDefines.h"
     1#include <Growl/GrowlDefines.h>
    22
    33#ifdef __OBJC__
    4 #       include "GrowlApplicationBridge.h"
     4#       include <Growl/GrowlApplicationBridge.h>
    55#endif
    6 #include "GrowlApplicationBridge-Carbon.h"
  • trunk/macosx/Growl.framework/Versions/A/Headers/GrowlApplicationBridge.h

    r10123 r13071  
    1919#import <Foundation/Foundation.h>
    2020#import <AppKit/AppKit.h>
    21 #import "GrowlDefines.h"
     21#import <Growl/GrowlDefines.h>
    2222
    2323//Forward declarations
    2424@protocol GrowlApplicationBridgeDelegate;
    25 
    26 //Internal notification when the user chooses not to install (to avoid continuing to cache notifications awaiting installation)
    27 #define GROWL_USER_CHOSE_NOT_TO_INSTALL_NOTIFICATION @"User chose not to install"
    2825
    2926//------------------------------------------------------------------------------
     
    4643 *      @abstract Detects whether Growl is installed.
    4744 *      @discussion Determines if the Growl prefpane and its helper app are installed.
    48  *      @result Returns YES if Growl is installed, NO otherwise.
    49  */
    50 + (BOOL) isGrowlInstalled;
     45 *      @result this method will forever return YES.
     46 */
     47+ (BOOL) isGrowlInstalled __attribute__((deprecated));
    5148
    5249/*!
     
    5754 */
    5855+ (BOOL) isGrowlRunning;
     56
     57
     58/*!
     59 *      @method isMistEnabled
     60 *      @abstract Gives the caller a fairly good indication of whether or not built-in notifications(Mist) will be used.
     61 *      @discussion since this call makes use of isGrowlRunning it is entirely possible for this value to change between call and
     62 *    executing a notification dispatch
     63 *      @result Returns YES if Growl isn't reachable and the developer has not opted-out of
     64 *    Mist and the user hasn't set the global mist enable key to false.
     65 */
     66+ (BOOL)isMistEnabled;
     67
     68/*!
     69 *      @method setShouldUseBuiltInNotifications
     70 *      @abstract opt-out mechanism for the mist notification style in the event growl can't be reached.
     71 *      @discussion if growl is unavailable due to not being installed or as a result of being turned off then
     72 *    this option can enable/disable a built-in fire and forget display style
     73 *      @param should Specifies whether or not the developer wants to opt-in (default) or opt out
     74 *    of the built-in Mist style in the event Growl is unreachable.
     75 */
     76+ (void)setShouldUseBuiltInNotifications:(BOOL)should;
     77
     78/*!
     79 *      @method shouldUseBuiltInNotifications
     80 *      @abstract returns the current opt-in state of the framework's use of the Mist display style.
     81 *      @result Returns NO if the developer opt-ed out of Mist, the default value is YES.
     82 */
     83+ (BOOL)shouldUseBuiltInNotifications;
    5984
    6085#pragma mark -
     
    324349 *       ---                                                                 -----
    325350 *       <code>GROWL_APP_NAME</code>                 <code>CFBundleExecutableName</code>
    326  *       <code>GROWL_APP_ICON</code>                 The icon of the application.
     351 *       <code>GROWL_APP_ICON_DATA</code>            The data of the icon of the application.
    327352 *       <code>GROWL_APP_LOCATION</code>             The location of the application.
    328353 *       <code>GROWL_NOTIFICATIONS_DEFAULT</code>    <code>GROWL_NOTIFICATIONS_ALL</code>
     
    345370 *       ---                                                                 -----
    346371 *       <code>GROWL_APP_NAME</code>                 <code>CFBundleExecutableName</code>
    347  *       <code>GROWL_APP_ICON</code>                 The icon of the application.
     372 *       <code>GROWL_APP_ICON_DATA</code>            The data of the icon of the application.
    348373 *       <code>GROWL_APP_LOCATION</code>             The location of the application.
    349374 *       <code>GROWL_NOTIFICATIONS_DEFAULT</code>    <code>GROWL_NOTIFICATIONS_ALL</code>
     
    369394 *
    370395 *       \li <code>GROWL_APP_NAME</code>
    371  *       \li <code>GROWL_APP_ICON</code>
     396 *       \li <code>GROWL_APP_ICON_DATA</code>
    372397 *
    373398 *      @since Growl.framework 1.1
     
    511536- (void) growlNotificationTimedOut:(id)clickContext;
    512537
     538
     539/*!
     540 * @method hasNetworkClientEntitlement
     541 * @abstract Used only in sandboxed situations since we don't know whether the app has com.apple.security.network.client entitlement
     542 * @discussion GrowlDelegate calls to find out if we have the com.apple.security.network.client entitlement,
     543 *  since we can't find this out without hitting the sandbox.  We only call it if we detect that the application is sandboxed.
     544 */
     545- (BOOL) hasNetworkClientEntitlement;
     546
    513547@end
    514548
    515549#pragma mark -
    516 /*!
    517  *      @category NSObject(GrowlApplicationBridgeDelegate_Installation_InformalProtocol)
    518  *      @abstract Methods which may be optionally implemented by the Growl delegate when used with Growl-WithInstaller.framework.
    519  *      @discussion The methods in this informal protocol will only be called if
    520  *       implemented by the delegate.  They allow greater control of the information
    521  *       presented to the user when installing or upgrading Growl from within your
    522  *       application when using Growl-WithInstaller.framework.
    523  */
    524 @interface NSObject (GrowlApplicationBridgeDelegate_Installation_InformalProtocol)
    525 
    526 /*!
    527  *      @method growlInstallationWindowTitle
    528  *      @abstract Return the title of the installation window.
    529  *      @discussion If not implemented, Growl will use a default, localized title.
    530  *      @result An NSString object to use as the title.
    531  */
    532 - (NSString *)growlInstallationWindowTitle;
    533 
    534 /*!
    535  *      @method growlUpdateWindowTitle
    536  *      @abstract Return the title of the upgrade window.
    537  *      @discussion If not implemented, Growl will use a default, localized title.
    538  *      @result An NSString object to use as the title.
    539  */
    540 - (NSString *)growlUpdateWindowTitle;
    541 
    542 /*!
    543  *      @method growlInstallationInformation
    544  *      @abstract Return the information to display when installing.
    545  *      @discussion This information may be as long or short as desired (the window
    546  *       will be sized to fit it).  It will be displayed to the user as an
    547  *       explanation of what Growl is and what it can do in your application.  It
    548  *       should probably note that no download is required to install.
    549  *
    550  *       If this is not implemented, Growl will use a default, localized explanation.
    551  *      @result An NSAttributedString object to display.
    552  */
    553 - (NSAttributedString *)growlInstallationInformation;
    554 
    555 /*!
    556  *      @method growlUpdateInformation
    557  *      @abstract Return the information to display when upgrading.
    558  *      @discussion This information may be as long or short as desired (the window
    559  *       will be sized to fit it).  It will be displayed to the user as an
    560  *       explanation that an updated version of Growl is included in your
    561  *       application and no download is required.
    562  *
    563  *       If this is not implemented, Growl will use a default, localized explanation.
    564  *      @result An NSAttributedString object to display.
    565  */
    566 - (NSAttributedString *)growlUpdateInformation;
    567 
    568 @end
    569 
    570 //private
    571 @interface GrowlApplicationBridge (GrowlInstallationPrompt_private)
    572 + (void) _userChoseNotToInstallGrowl;
    573 @end
    574550
    575551#endif /* __GrowlApplicationBridge_h__ */
  • trunk/macosx/Growl.framework/Versions/A/Headers/GrowlDefines.h

    r10123 r13071  
    88#ifdef __OBJC__
    99#define XSTR(x) (@x)
    10 #define STRING_TYPE NSString *
    1110#else
    1211#define XSTR CFSTR
    13 #define STRING_TYPE CFStringRef
    1412#endif
    1513
     
    5755 */
    5856#define GROWL_APP_ID                                    XSTR("ApplicationId")
    59 /*!     @defined GROWL_APP_ICON
     57/*!     @defined GROWL_APP_ICON_DATA
    6058 *      @abstract The image data for your application's icon.
    6159 *      @discussion Image data representing your application's icon. This may be
     
    6765 *       Optional. Not supported by all display plugins.
    6866 */
    69 #define GROWL_APP_ICON                                  XSTR("ApplicationIcon")
     67#define GROWL_APP_ICON_DATA                             XSTR("ApplicationIcon")
    7068/*!     @defined GROWL_NOTIFICATIONS_DEFAULT
    7169 *      @abstract The array of notifications to turn on by default.
     
    145143#define GROWL_NOTIFICATION_DESCRIPTION          XSTR("NotificationDescription")
    146144/*!     @defined GROWL_NOTIFICATION_ICON
    147  *      @discussion Image data for the notification icon. Must be in a format
     145 *      @discussion Image data for the notification icon. Image data must be in a format
    148146 *       supported by NSImage, such as TIFF, PNG, GIF, JPEG, BMP, PICT, or PDF.
    149147 *
    150148 *       Optional. Not supported by all display plugins.
    151149 */
    152 #define GROWL_NOTIFICATION_ICON                 XSTR("NotificationIcon")
     150#define GROWL_NOTIFICATION_ICON_DATA                    XSTR("NotificationIcon")
    153151/*!     @defined GROWL_NOTIFICATION_APP_ICON
    154152 *      @discussion Image data for the application icon, in case GROWL_APP_ICON does
    155  *       not apply for some reason. Must be in a format supported by NSImage, such
     153 *       not apply for some reason. Image data be in a format supported by NSImage, such
    156154 *       as TIFF, PNG, GIF, JPEG, BMP, PICT, or PDF.
    157155 *
    158156 *       Optional. Not supported by all display plugins.
    159157 */
    160 #define GROWL_NOTIFICATION_APP_ICON             XSTR("NotificationAppIcon")
     158#define GROWL_NOTIFICATION_APP_ICON_DATA                XSTR("NotificationAppIcon")
    161159/*!     @defined GROWL_NOTIFICATION_PRIORITY
    162160 *      @discussion The priority of the notification as an integer number from
     
    185183 */
    186184#define GROWL_NOTIFICATION_CLICK_CONTEXT                        XSTR("NotificationClickContext")
    187 
    188 /*!     @defined GROWL_DISPLAY_PLUGIN
    189  *      @discussion The name of a display plugin which should be used for this notification.
    190  *    Optional. If this key is not set or the specified display plugin does not
    191  *    exist, the display plugin stored in the application ticket is used. This key
    192  *    allows applications to use different default display plugins for their
    193  *    notifications. The user can still override those settings in the preference
    194  *    pane.
    195  */
    196 #define GROWL_DISPLAY_PLUGIN                            XSTR("NotificationDisplayPlugin")
    197185
    198186/*!     @defined GROWL_NOTIFICATION_IDENTIFIER
     
    246234 *       <ul>
    247235 *              <li>GROWL_APP_NAME</li>
    248  *              <li>GROWL_APP_ICON</li>
     236 *              <li>GROWL_APP_ICON_DATA</li>
    249237 *              <li>GROWL_NOTIFICATIONS_ALL</li>
    250238 *              <li>GROWL_NOTIFICATIONS_DEFAULT</li>
     
    289277 */
    290278#define GROWL_NOTIFICATION                              XSTR("GrowlNotification")
    291 /*!     @defined GROWL_SHUTDOWN
    292 *       @abstract The distributed notification name that tells Growl to shutdown.
    293 *       @discussion The Growl preference pane posts this notification when the
    294 *        "Stop Growl" button is clicked.
    295 */
    296 #define GROWL_SHUTDOWN                                  XSTR("GrowlShutdown")
    297279/*!     @defined GROWL_PING
    298280 *      @abstract A distributed notification to check whether Growl is running.
     
    314296 */
    315297#define GROWL_IS_READY                                  XSTR("Lend Me Some Sugar; I Am Your Neighbor!")
    316 /*!     @defined GROWL_NOTIFICATION_CLICKED
    317  *      @abstract The distributed notification sent when a supported notification is clicked.
     298
     299
     300/*!     @defined GROWL_DISTRIBUTED_NOTIFICATION_CLICKED_SUFFIX
     301 *      @abstract Part of the name of the distributed notification sent when a supported notification is clicked.
    318302 *      @discussion When a Growl notification with a click context is clicked on by
    319  *       the user, Growl posts this distributed notification.
    320  *       The GrowlApplicationBridge responds to this notification by calling a
    321  *       callback in its delegate.
    322  */
    323 #define GROWL_NOTIFICATION_CLICKED              XSTR("GrowlClicked!")
    324 #define GROWL_NOTIFICATION_TIMED_OUT    XSTR("GrowlTimedOut!")
     303 *       the user, Growl posts a distributed notification whose name is in the format:
     304 *        [NSString stringWithFormat:@"%@-%d-%@", appName, pid, GROWL_DISTRIBUTED_NOTIFICATION_CLICKED_SUFFIX]
     305 *       The GrowlApplicationBridge responds to this notification by calling a callback in its delegate.
     306 */
     307#define GROWL_DISTRIBUTED_NOTIFICATION_CLICKED_SUFFIX           XSTR("GrowlClicked!")
     308
     309/*!     @defined GROWL_DISTRIBUTED_NOTIFICATION_TIMED_OUT_SUFFIX
     310 *      @abstract Part of the name of the distributed notification sent when a supported notification times out without being clicked.
     311 *      @discussion When a Growl notification with a click context times out, Growl posts a distributed notification
     312 *       whose name is in the format:
     313 *                [NSString stringWithFormat:@"%@-%d-%@", appName, pid, GROWL_DISTRIBUTED_NOTIFICATION_TIMED_OUT_SUFFIX]
     314 *       The GrowlApplicationBridge responds to this notification by calling a callback in its delegate.
     315 *   NOTE: The user may have actually clicked the 'close' button; this triggers an *immediate* time-out of the notification.
     316 */
     317#define GROWL_DISTRIBUTED_NOTIFICATION_TIMED_OUT_SUFFIX         XSTR("GrowlTimedOut!")
    325318
    326319/*!     @group Other symbols */
  • trunk/macosx/Growl.framework/Versions/A/Resources/Info.plist

    r12460 r13071  
    44<dict>
    55        <key>BuildMachineOSBuild</key>
    6         <string>10J869</string>
     6        <string>11A511</string>
    77        <key>CFBundleDevelopmentRegion</key>
    88        <string>English</string>
     
    1616        <string>FMWK</string>
    1717        <key>CFBundleShortVersionString</key>
    18         <string>1.2.2</string>
     18        <string>1.3</string>
    1919        <key>CFBundleSignature</key>
    2020        <string>GRRR</string>
    2121        <key>CFBundleVersion</key>
    22         <string>1.2.2</string>
     22        <string>1.3</string>
    2323        <key>DTCompiler</key>
    24         <string>4.0</string>
     24        <string>com.apple.compilers.llvm.clang.1_0</string>
    2525        <key>DTPlatformBuild</key>
    26         <string>10M2518</string>
     26        <string>4D199</string>
    2727        <key>DTPlatformVersion</key>
    28         <string>PG</string>
     28        <string>GM</string>
    2929        <key>DTSDKBuild</key>
    30         <string>9L31a</string>
     30        <string>11C63</string>
    3131        <key>DTSDKName</key>
    32         <string>macosx10.5</string>
     32        <string>macosx10.7</string>
    3333        <key>DTXcode</key>
    34         <string>0400</string>
     34        <string>0420</string>
    3535        <key>DTXcodeBuild</key>
    36         <string>10M2518</string>
     36        <string>4D199</string>
    3737        <key>NSPrincipalClass</key>
    3838        <string>GrowlApplicationBridge</string>
Note: See TracChangeset for help on using the changeset viewer.