# 1.6.5

- The device identifier, the session identifier and sending an issue (issue, crash or user feedback) will return now URLs to the Bugfender's Dashboard. This can be used to create automations and to integrate BugfenderSDK with third party tools
- Fixed race condition that may prevent some crashes to be correctly displayed in the Bugfender's Dashboard
- Added new method allowing developers to manually send crash reports to Bugfender

.swift-version

@@ -1 +1 @@
-3.1
+4.0

BFUserFeedbackNavigationController.h

@@ -40,7 +40,7 @@ NS_ASSUME_NONNULL_BEGIN
                                                          messagePlaceholder:(NSString *)messagePlaceholder
                                                             sendButtonTitle:(NSString *)sendButtonTitle
                                                           cancelButtonTitle:(NSString *)cancelButtonTitle
-                                                                 completion:(void (^)(BOOL feedbackSent))completionBlock;
+                                                                 completion:(void (^)(BOOL feedbackSent, NSURL * _Nullable url))completionBlock;
 
 
 @end

BFUserFeedbackViewController.h

@@ -74,7 +74,7 @@ NS_ASSUME_NONNULL_BEGIN
 /**
  Pass a block if you want to be notified after feedback was sent (or not)
  */
-@property (nonatomic, copy) void (^completionBlock)(BOOL feedbackSent);
+@property (nonatomic, copy) void (^completionBlock)(BOOL feedbackSent, NSURL * _Nullable url);
 
 @end
 

BugfenderSDK.framework/Headers/BFUserFeedbackNavigationController.h

@@ -40,7 +40,7 @@ NS_ASSUME_NONNULL_BEGIN
                                                          messagePlaceholder:(NSString *)messagePlaceholder
                                                             sendButtonTitle:(NSString *)sendButtonTitle
                                                           cancelButtonTitle:(NSString *)cancelButtonTitle
-                                                                 completion:(void (^)(BOOL feedbackSent))completionBlock;
+                                                                 completion:(void (^)(BOOL feedbackSent, NSURL * _Nullable url))completionBlock;
 
 
 @end

BugfenderSDK.framework/Headers/BFUserFeedbackViewController.h

@@ -74,7 +74,7 @@ NS_ASSUME_NONNULL_BEGIN
 /**
  Pass a block if you want to be notified after feedback was sent (or not)
  */
-@property (nonatomic, copy) void (^completionBlock)(BOOL feedbackSent);
+@property (nonatomic, copy) void (^completionBlock)(BOOL feedbackSent, NSURL * _Nullable url);
 
 @end
 

BugfenderSDK.framework/Headers/BugfenderSDK.h

@@ -5,8 +5,7 @@
 //
 
 #import <Foundation/Foundation.h>
-@class BFUserFeedbackNavigationController;
-
+#import <BugfenderSDK/BFUserFeedbackNavigationController.h>
 NS_ASSUME_NONNULL_BEGIN
 
 #define BFLibraryVersionNumber_0_1_0  0
@@ -63,6 +62,7 @@ NS_ASSUME_NONNULL_BEGIN
 #define BFLibraryVersionNumber_1_6_2  51
 #define BFLibraryVersionNumber_1_6_3  52
 #define BFLibraryVersionNumber_1_6_4  53
+#define BFLibraryVersionNumber_1_6_5  54
 
 /**
  * Current Bugfender version number.
@@ -107,6 +107,14 @@ typedef NS_ENUM(NSUInteger, BFLogLevel)
  */
 + (void)setApiURL:(NSURL*)url;
 
+/**
+ * Sets the URL of the Bugfender Dashboard
+ * @discussion Usage of this function is not necessary in the general use case. Please use exclusively when
+ * directed from technical support. This method must be called before activateLogger.
+ * @param url base URL of the Bugfender's dashboard
+ */
++ (void)setBaseURL:(NSURL*)url;
+
 /**
  * Activates the Bugfender for a specific app.
  * @param appKey The app key of the Bugfender application, get it in bugfender.com
@@ -141,14 +149,32 @@ typedef NS_ENUM(NSUInteger, BFLogLevel)
  * The device identifier is constant while the application is installed in the device.
  * @return A string identifying the device.
  **/
-+ (NSString*)deviceIdentifier;
++ (NSString*)deviceIdentifier __deprecated_msg("Use deviceIdentifierUrl instead.");
+
+/**
+ * Returns a URL linking to the current device in bugfender.
+ * @discussion This url can be sent to your server and used to create integrations with other services. Also can be stored to
+ * keep a relationship between a Bugfender device and a user or some other important event in your application.
+ *
+ * The device identifier is constant while the application is installed in the device.
+ * @return URL linking to the device in Bugfender
+ **/
++ (NSURL *)deviceIdentifierUrl;
 
 /**
  *
  * The session identifier is constant while the application is running.
  * @return A string identifying the current session.
  */
-+ (NSString *)sessionIdentifier;
++ (NSString *)sessionIdentifier __deprecated_msg("Use sessionIdentifierUrl instead.");
+
+/**
+ *
+ * The session identifier url is constant while the application is running.
+ * @discussion This url can be sent to your server and used to create integrations with other services.
+ * @return A URL linking to the current session in Bugfender.
+ */
++ (NSURL *)sessionIdentifierUrl;
 
 /**
  * Synchronizes all logs with the server all the time, regardless if this device is enabled or not.
@@ -278,7 +304,29 @@ typedef NS_ENUM(NSUInteger, BFLogLevel)
  * @param text Full details of the issue. Markdown format is accepted.
  * @return the issue identifier
  */
-+ (NSString *)sendIssueWithTitle:(NSString *)title text:(NSString *)text;
++ (NSString *)sendIssueWithTitle:(NSString *)title text:(NSString *)text __deprecated_msg("Use sendIssueReturningUrlWithTitle:text: instead.");
+
+/**
+ * Sends an issue
+ * @discussion Sending an issue forces the logs of the current session being sent
+ * to the server, and marks the session so that it is highlighted in the web console.
+ * @param title Short description of the issue.
+ * @param text Full details of the issue. Markdown format is accepted.
+ * @return an URL linking to the issue in Bugfender
+ */
++ (NSURL *)sendIssueReturningUrlWithTitle:(NSString *)title text:(NSString *)text;
+
+#pragma mark - Crashes
+
+/**
+ * Sends a crash
+ * @discussion This method will send immediately a crash to the server
+ * it doesn't take into account if crash reporting is enabled or not
+ * @param title Short description of the crash.
+ * @param text Full details of the crarsh.
+ * @return an URL linking to the crash in Bugfender
+ */
++ (NSURL *)sendCrashWithTitle:(NSString *)title text:(NSString *)text;
 
 #pragma mark - User Feedback
 
@@ -302,15 +350,24 @@ typedef NS_ENUM(NSUInteger, BFLogLevel)
                                                          messagePlaceholder:(NSString *)messagePlaceholder
                                                             sendButtonTitle:(NSString *)sendButtonTitle
                                                           cancelButtonTitle:(NSString *)cancelButtonTitle
-                                                                 completion:(void (^ _Nullable )(BOOL feedbackSent))completionBlock;
+                                                                 completion:(void (^ _Nullable )(BOOL feedbackSent, NSURL * _Nullable url))completionBlock;
 
 /**
  Allows to create custom UI to gather user feedback and send to Bugfender.
 
  @param subject subject of the feedback
  @param message message of the feedback
  */
-+ (void)sendUserFeedbackWithSubject:(NSString *)subject message:(NSString *)message;
++ (void)sendUserFeedbackWithSubject:(NSString *)subject message:(NSString *)message __deprecated_msg("Use sendUserFeedbackReturningUrlWithSubject:message: instead.");
+
+/**
+ Allows to create custom UI to gather user feedback and send to Bugfender.
+ 
+ @param subject subject of the feedback
+ @param message message of the feedback
+ @return URL linking to Bugfender
+ */
++ (NSURL *)sendUserFeedbackReturningUrlWithSubject:(NSString *)subject message:(NSString *)message;
 
 @end
 

BugfenderSDK.framework/Modules/module.modulemap

@@ -1,6 +1,6 @@
 framework module BugfenderSDK {
-  umbrella header "BugfenderSDK.h"
-  header "BFUserFeedbackNavigationController.h"
-  module * { export * }
-  export *
+    umbrella header "BugfenderSDK.h"
+    
+    module * { export * }
+    export *
 }

BugfenderSDK.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name     = 'BugfenderSDK'
-  s.version  = '1.6.4'
+  s.version  = '1.6.5'
   s.ios.deployment_target     = '8.0'
   s.license  = { :type => 'Commercial', :text => 'See https://bugfender.com/terms-of-service/' }
   s.summary  = 'Bugfender: a mobile remote logger'

CHANGELOG.md

@@ -1,3 +1,8 @@
+# 1.6.5
+- The device identifier, the session identifier and sending an issue (issue, crash or user feedback) will return now URLs to the Bugfender's Dashboard. This can be used to create automations and to integrate BugfenderSDK with third party tools
+- Fixed race condition that may prevent some crashes to be correctly displayed in the Bugfender's Dashboard
+- Added new method allowing developers to manually send crash reports to Bugfender
+
 # 1.6.4
 - Fixed an async task that may block a background thread 
 - Improved how user defined key-values synchronize with the server