Allow custom base override

Sources/KSCrashRecording/KSCrash.m

@@ -61,6 +61,8 @@ @interface KSCrash ()
 
 @end
 
+static NSString *gCustomBasePath = nil;
+static BOOL gIsSharedInstanceCreated = NO;
 
 static NSString* getBundleName(void)
 {
@@ -74,6 +76,11 @@ @interface KSCrash ()
 
 static NSString* getBasePath(void)
 {
+    if(gCustomBasePath != nil)
+    {
+        return gCustomBasePath;
+    }
+
     NSArray* directories = NSSearchPathForDirectoriesInDomains(NSCachesDirectory,
                                                                NSUserDomainMask,
                                                                YES);
@@ -121,23 +128,32 @@ + (void)initialize
     }
 }
 
++ (void) setBasePath:(NSString*) basePath;
+{
+    if(basePath == gCustomBasePath || [basePath isEqualToString:gCustomBasePath])
+    {
+        return;
+    }
+    if(gIsSharedInstanceCreated)
+    {
+        KSLOG_WARN(@"A shared instance of KSCrash is already created. Can't change the base path to: %@", basePath);
+    }
+    gCustomBasePath = [basePath copy];
+}
+
 + (instancetype) sharedInstance
 {
     static KSCrash *sharedInstance = nil;
     static dispatch_once_t onceToken;
 
     dispatch_once(&onceToken, ^{
-        sharedInstance = [[KSCrash alloc] init];
+        sharedInstance = [[KSCrash alloc] initWithBasePath:getBasePath()];
+        gIsSharedInstanceCreated = YES;
     });
     return sharedInstance;
 }
 
-- (instancetype) init
-{
-    return [self initWithBasePath:getBasePath()];
-}
-
-- (instancetype) initWithBasePath:(NSString *)basePath
+- (instancetype) initWithBasePath:(NSString*) basePath
 {
     if((self = [super init]))
     {

Sources/KSCrashRecording/include/KSCrash.h

@@ -105,10 +105,24 @@ NS_ASSUME_NONNULL_BEGIN
 
 #pragma mark - API -
 
-/** Init KSCrash instance with custom base path. */
-- (instancetype) initWithBasePath:(NSString*) basePath;
+- (instancetype) init NS_UNAVAILABLE;
++ (instancetype) new NS_UNAVAILABLE;
+
+/**
+ * Specifies a custom base path for KSCrash installation.
+ * By default a "KSCrash" directory inside the default cache directory is used.
+ *
+ * @param basePath An absolute path to directory in which KSCrash stores the data.
+ *                 If `nil` the default directory is used.
+ *
+ * @note This method SHOULD be called before any use of `sharedInstance` method.
+ *       Any call of this method after that is ignored.
+ */
++ (void) setBasePath:(nullable NSString*) basePath;