minor changes and documenattion enhancements

Author: mralexgray

DVTCompatibilitizer.m

@@ -27,6 +27,7 @@ It watches certain (which)? places for changes in your
 #define			kXcodePluginSuffix	@"xcplugin"
 #define  kPluginsDirectoryPath	@"~/Library/Application Support/Developer/Shared/Xcode/Plug-ins/"
 #define  kCompatibilityUUIDKey	@"DVTPlugInCompatibilityUUID"
+#define  kNotifierProxyAppName  @"DVTCompatibilitizerNotificationProxy"
 #define kCompatibilityUUIDsKey  kCompatibilityUUIDKey @"s"
 #define    kInfoPlistComponent	@"Contents/Info.plist"
 #define                   ARGV  ((NSArray<NSString*>*)NSProcessInfo.processInfo.arguments)
@@ -120,9 +121,9 @@ + (NSArray*) fixPlugins { // check and fix out little babies.  (TESTABLE)
 
 + (void) _notify:reason {  // Posts notifications on our behalf!
 
-  id notifier = [[[NSBundle bundleForClass:self]
-								pathForAuxiliaryExecutable:@"DVTCompatibilitizer.notfier.app"]
-						stringByAppendingPathComponent:@"Contents/MacOS/applet"];
+  static id notifier; notifier = notifier ?: [[[NSBundle bundleForClass:self]
+                                             pathForAuxiliaryExecutable:kNotifierProxyAppName]
+                                         stringByAppendingPathComponent:@"Contents/MacOS/applet"];
 
   system([[NSString stringWithFormat:@"title=\"%@\" message=\"%@\" \"%@\"", NSStringFromClass(self),
 																																						reason ?: @"DVTCompatibilitized!",
@@ -132,6 +133,7 @@ + (void) _notify:reason {  // Posts notifications on our behalf!
 + (BOOL) _keysAreOK:(NSArray*)pluginIDs { // Checks a single plugin's list of UUIDS making sure all of OUR Xcodes are there.
 
   __block BOOL missingUUID = NO;
+
   [self.installedXcodes enumerateKeysAndObjectsUsingBlock:^(id  _Nonnull key, id  _Nonnull obj, BOOL * _Nonnull stop) {
 
     if (![pluginIDs containsObject:obj]) missingUUID = *stop = YES;
@@ -244,7 +246,7 @@ int main() { @autoreleasepool {
 
   if (ARGV.count == 1) return DVTCompatibilitizer._watchAndFixPluginsAsNeeded;
 
-  id arg = ARGV[1].lowercaseString;
+  id arg = ARGV[1].lowercaseString;  // special launch!
 
   return [arg containsString: @"dog"] ? launchWatchDog() // on first run
        : [arg containsString:@"help"] ? usage()

DVTPlugInCompatibilityUUIDifier.m

@@ -1,21 +1,25 @@
 
-/*! @brief This class loads - when Xcode decides it wants to allow this plugin to startup.
-    @note Please see enclosed README for important implementation details.
+/*! @brief      This class loads - when Xcode decides it wants to allow this plugin to startup.
+    @note       Please see enclosed README for important implementation details.
+    @discussion Theoretically, this plugin doesn't need to do ANYTHING.  
+                The watchdog should theoretically ALWAYS be running after first installed.
+                This plug-in simply ensures it IS running, every time Xcode launches.
 */
 
-@import Foundation;
-
-extern BOOL launchWatchDog();
+@import         Foundation;
+extern BOOL     launchWatchDog(); // Installs launch agent, etc.
 
 @interface			DVTPlugInCompatibilityUUIDifier : NSObject @end
 @implementation DVTPlugInCompatibilityUUIDifier
 
 + (void) pluginDidLoad:(NSBundle*)me {
 
-	static id x = nil; static dispatch_once_t token; dispatch_once(&token,^{ x = self.new; });
+  static dispatch_once_t tkn; dispatch_once(&tkn,^{ launchWatchDog(); });
+
+//	static id x = nil; static dispatch_once_t tkn; dispatch_once(&tkn,^{ x = self.new; });
 }
 
-- init { return self = super.init ? launchWatchDog(), self : nil; }
+//- init { return self = super.init ? launchWatchDog(), self : nil; }
 
 @end
 

DVTPlugInCompatibilityUUIDifier.xcodeproj/project.pbxproj

@@ -11,9 +11,9 @@
 		7B2693851C56C8A200D626B5 /* AHLaunchJob.m in Sources */ = {isa = PBXBuildFile; fileRef = 7B6A68081BE046D80023C7D8 /* AHLaunchJob.m */; };
 		7B2693861C56C8A200D626B5 /* AHServiceManagement.m in Sources */ = {isa = PBXBuildFile; fileRef = 7B6A680C1BE046D80023C7D8 /* AHServiceManagement.m */; };
 		7B2693871C56C8A200D626B5 /* NSString+ah_versionCompare.m in Sources */ = {isa = PBXBuildFile; fileRef = 7B6A68111BE046D80023C7D8 /* NSString+ah_versionCompare.m */; };
+		7B2C222E1CA9EF200064B31E /* DVTCompatibilitizerNotificationProxy.app in CopyFiles */ = {isa = PBXBuildFile; fileRef = 7B2C222D1CA9EF190064B31E /* DVTCompatibilitizerNotificationProxy.app */; settings = {ATTRIBUTES = (RemoveHeadersOnCopy, ); }; };
 		7B6A67C81BE02CFA0023C7D8 /* DVTCompatibilitizer.m in Sources */ = {isa = PBXBuildFile; fileRef = 7B91FE911BE023E200F3BF55 /* DVTCompatibilitizer.m */; };
 		7B6A67CE1BE03FED0023C7D8 /* DVTPlugInCompatibilityWatchdog in CopyFiles */ = {isa = PBXBuildFile; fileRef = 7B6A67C21BE02C980023C7D8 /* DVTPlugInCompatibilityWatchdog */; settings = {ATTRIBUTES = (CodeSignOnCopy, ); }; };
-		7B6A67D01BE0400E0023C7D8 /* DVTCompatibilitizer.notfier.app in CopyFiles */ = {isa = PBXBuildFile; fileRef = 7B6A67CF1BE0400A0023C7D8 /* DVTCompatibilitizer.notfier.app */; settings = {ATTRIBUTES = (RemoveHeadersOnCopy, ); }; };
 		7B6A68131BE046D80023C7D8 /* AHLaunchCtl.m in Sources */ = {isa = PBXBuildFile; fileRef = 7B6A68061BE046D80023C7D8 /* AHLaunchCtl.m */; };
 		7B6A68141BE046D80023C7D8 /* AHLaunchJob.m in Sources */ = {isa = PBXBuildFile; fileRef = 7B6A68081BE046D80023C7D8 /* AHLaunchJob.m */; };
 		7B6A68161BE046D80023C7D8 /* AHServiceManagement.m in Sources */ = {isa = PBXBuildFile; fileRef = 7B6A680C1BE046D80023C7D8 /* AHServiceManagement.m */; };
@@ -48,17 +48,17 @@
 			dstSubfolderSpec = 6;
 			files = (
 				7B6A67CE1BE03FED0023C7D8 /* DVTPlugInCompatibilityWatchdog in CopyFiles */,
-				7B6A67D01BE0400E0023C7D8 /* DVTCompatibilitizer.notfier.app in CopyFiles */,
+				7B2C222E1CA9EF200064B31E /* DVTCompatibilitizerNotificationProxy.app in CopyFiles */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
 /* End PBXCopyFilesBuildPhase section */
 
 /* Begin PBXFileReference section */
-		7B2153371BE0545900BDE9AE /* README.md */ = {isa = PBXFileReference; lastKnownFileType = net.daringfireball.markdown; path = README.md; sourceTree = "<group>"; };
+		7B2153371BE0545900BDE9AE /* README.md */ = {isa = PBXFileReference; lastKnownFileType = net.daringfireball.markdown; path = README.md; sourceTree = "<group>"; wrapsLines = 1; };
 		7B2693811C56C70800D626B5 /* WatchDogLauncher.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = WatchDogLauncher.m; sourceTree = "<group>"; };
+		7B2C222D1CA9EF190064B31E /* DVTCompatibilitizerNotificationProxy.app */ = {isa = PBXFileReference; lastKnownFileType = wrapper.application; path = DVTCompatibilitizerNotificationProxy.app; sourceTree = "<group>"; };
 		7B6A67C21BE02C980023C7D8 /* DVTPlugInCompatibilityWatchdog */ = {isa = PBXFileReference; explicitFileType = "compiled.mach-o.executable"; includeInIndex = 0; path = DVTPlugInCompatibilityWatchdog; sourceTree = BUILT_PRODUCTS_DIR; };
-		7B6A67CF1BE0400A0023C7D8 /* DVTCompatibilitizer.notfier.app */ = {isa = PBXFileReference; lastKnownFileType = wrapper.application; path = DVTCompatibilitizer.notfier.app; sourceTree = "<group>"; };
 		7B6A68021BE046D80023C7D8 /* AHAuthorizer.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = AHAuthorizer.h; sourceTree = "<group>"; };
 		7B6A68031BE046D80023C7D8 /* AHAuthorizer.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = AHAuthorizer.m; sourceTree = "<group>"; };
 		7B6A68041BE046D80023C7D8 /* AHLaunchCtl-Prefix.pch */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = "AHLaunchCtl-Prefix.pch"; sourceTree = "<group>"; };
@@ -141,8 +141,8 @@
 		7B8BD8D11C99F8BA00C6B44A /* Plug-In */ = {
 			isa = PBXGroup;
 			children = (
+				7B2C222D1CA9EF190064B31E /* DVTCompatibilitizerNotificationProxy.app */,
 				D2E2D2E016D42CCC00447430 /* DVTPlugInCompatibilityUUIDifier-Info.plist */,
-				7B6A67CF1BE0400A0023C7D8 /* DVTCompatibilitizer.notfier.app */,
 				7B953EEE1BE00F0500EB7F15 /* DVTPlugInCompatibilityUUIDifier.m */,
 			);
 			name = "Plug-In";

README.md

@@ -3,7 +3,7 @@
 
 ![Sreneity Now](https://github.com/mralexgray/DVTPlugInCompatibilityUUIDifier/raw/master/Screenshots/alcatraz.art.png)
 
-## _Permanent, automatic, and hassle-free_ `Xcode`/`Alcatraz` "compatibility" upgrades.
+## _Permanent, automatic, and hassle-free_ `Xcode`/`Alcatraz` "`UUID compatibility`" "upgrades".
 
 - [x] Are you *sick and tired* of thinking about / dealing with `Alcatraz` / all your `Xcode` plugins breaking with each `Xcode` release?
 
@@ -63,6 +63,26 @@ and restart `Xcode`.
 
 ## Big picture / implementation details.
 
+DVTPlugInCompatibilityUUIDifier.xcplugin  
+└── Contents
+    ├── Info.plist
+    └── MacOS
+        ├── DVTPlugInCompatibilityUUIDifier  // The bundle's executable.
+        ├── DVTPlugInCompatibilityWatchdog   // The LaunchAgent that will always run.
+        └── DVTCompatibilitizer.notfier.app  // This bunlded app handles notifications
+            └── Contents
+                ├── Info.plist
+                ├── MacOS
+                │   └── applet
+                ├── PkgInfo
+                └── Resources
+                    ├── Scripts
+                    │   └── main.scpt
+                    ├── applet.icns
+                    ├── applet.rsrc
+                    └── description.rtfd
+                        └── TXT.rtf
+
 First of all, this project requires [AHLaunchCTL](https://github.com/mralexgray/AHLaunchCTL).  However, if you forget to update/init your submodules, there is a pre-build step, 
 
     if [ ! -d AHLaunchCTL ]; then git submodule update --init --recursive; fi
@@ -85,6 +105,11 @@ The solution is a bit hacky.. but again, inside of Xcode's build settings, I've
 
 which simply brute-force launches the included watchdog. This way.. EVEN if Xcode NEVER has loaded this plugin (due to it being fucking UUID incompatible)...  it won't matter.  Simply by being built successfully... the watchdog will be running.. and you will be protectced from the ravages of small inconvenience!
 
+## Tests
+
+Not only does the watchdog protect you from Alcatraz's refusal to self-update, and Apple's Nazi-esque "compatibility" police..  but it can ALSO test itself...  This isn't more than an internal mechanisms, but I might as well document it here, for my own benfit.
+
+
 ## Twitter
 
 I'm [@mralexgray](http://twitter.com/mralexgray) on Twitter. Please [tweet](https://twitter.com/intent/tweet?button_hashtag=DVTPlugInCompatibilityUUIDifier&text=Permanent%2C+automatic%2C+and+hassle-free+Xcode%2FAlcatraz+upgrades.%20http%3A%2F%2Flinks.mrgray.com%2FMoPluginsMoProblems&via=mralexgray) about the plugin.