fix(ios): Instagram singleShare iOS crash (#1667)

* Fix ig single share crash by adding missing permissions request

* Update docs

Author: dawidzawada

ios/InstagramShare.m

@@ -14,9 +14,9 @@ @implementation InstagramShare
 - (void)shareSingle:(NSDictionary *)options
     reject:(RCTPromiseRejectBlock)reject
     resolve:(RCTPromiseResolveBlock)resolve {
-    
+
     NSLog(@"Try open view");
-    
+
     NSURL * shareURL;
     float videoDurationSeconds = 0.0f;
     NSString* url = options[@"url"];
@@ -25,13 +25,13 @@ - (void)shareSingle:(NSDictionary *)options
         AVURLAsset* videoAsset = [AVURLAsset URLAssetWithURL:fileURL options:nil];
         CMTime videoDuration = videoAsset.duration;
         float videoDurationSeconds = CMTimeGetSeconds(videoDuration);
-        
+
         NSLog(@"Video duration: %f seconds for file %@", videoDurationSeconds, videoAsset.URL.absoluteString);
     } else {
         //this will send message directly to instagram DM with plain text
         shareURL = [NSURL URLWithString:[NSString stringWithFormat:@"instagram://sharesheet?text=%@", options[@"message"]]];
     }
-    
+
     if (shareURL) {
         NSLog(@"url is already available, no need to do anything");
     } else if (videoDurationSeconds <= 60.0f) {
@@ -42,30 +42,30 @@ - (void)shareSingle:(NSDictionary *)options
     } else {
         shareURL = [NSURL URLWithString:@"instagram://camera"];
     }
-    
+
     if ([[UIApplication sharedApplication] canOpenURL: shareURL]) {
         [[UIApplication sharedApplication] openURL:shareURL options:@{} completionHandler:nil];
         resolve(@[@true, @""]);
     } else {
         // Cannot open instagram
         NSString *stringURL = @"https://itunes.apple.com/app/instagram/id389801252";
         NSURL *url = [NSURL URLWithString:stringURL];
-        
+
         [[UIApplication sharedApplication] openURL:url options:@{} completionHandler:^(BOOL success) {}];
-        
+
         NSString *errorMessage = @"Not installed";
         NSDictionary *userInfo = @{NSLocalizedFailureReasonErrorKey: NSLocalizedString(errorMessage, nil)};
         NSError *error = [NSError errorWithDomain:@"com.rnshare" code:1 userInfo:userInfo];
-        
+
         NSLog(@"%@", errorMessage);
         reject(@"com.rnshare",@"Not installed",error);
-    } 
+    }
 }
 
 - (void)shareSingleImage:(NSDictionary *)options
          reject:(RCTPromiseRejectBlock)reject
          resolve:(RCTPromiseResolveBlock)resolve {
-    
+
     UIImage *image;
     NSURL *imageURL = [RCTConvert NSURL:options[@"url"]];
     if (imageURL) {
@@ -92,22 +92,45 @@ - (void)shareSingleImage:(NSDictionary *)options
 -(void)savePictureAndOpenInstagram:(UIImage *)base64Image
                    reject:(RCTPromiseRejectBlock)reject
                    resolve:(RCTPromiseResolveBlock)resolve {
-    
+
+    // Check for photo library permissions
+    PHAuthorizationStatus status = [PHPhotoLibrary authorizationStatus];
+    if (status == PHAuthorizationStatusNotDetermined) {
+        [PHPhotoLibrary requestAuthorization:^(PHAuthorizationStatus newStatus) {
+            dispatch_async(dispatch_get_main_queue(), ^{
+                if (newStatus == PHAuthorizationStatusAuthorized) {
+                    [self savePictureAndOpenInstagram:base64Image reject:reject resolve:resolve];
+                } else {
+                    if (reject != NULL) {
+                        reject(@"com.rnshare", @"Photo library access denied by user", nil);
+                    }
+                }
+            });
+        }];
+        return;
+    } else if (status != PHAuthorizationStatusAuthorized) {
+
+        if (reject != NULL) {
+            reject(@"com.rnshare", @"Photo library access not authorized", nil);
+        }
+        return;
+    }
+
     NSURL *URL = [self fileURLWithTemporaryImageData:UIImageJPEGRepresentation(base64Image, 0.9)];
     __block PHAssetChangeRequest *_mChangeRequest = nil;
     __block PHObjectPlaceholder *placeholder;
-    
+
     [[PHPhotoLibrary sharedPhotoLibrary] performChanges:^{
-        
+
         NSData *pngData = [NSData dataWithContentsOfURL:URL];
         UIImage *image = [UIImage imageWithData:pngData];
         _mChangeRequest = [PHAssetChangeRequest creationRequestForAssetFromImage:image];
         placeholder = _mChangeRequest.placeholderForCreatedAsset;
     } completionHandler:^(BOOL success, NSError *error) {
-        
+
         if (success) {
             NSURL *instagramURL = [NSURL URLWithString:[NSString stringWithFormat:@"instagram://library?LocalIdentifier=\%@", [placeholder localIdentifier]]];
-            
+
             if ([[UIApplication sharedApplication] canOpenURL:instagramURL]) {
                 if (@available(iOS 10.0, *)) {
                     [[UIApplication sharedApplication] openURL:instagramURL options:@{} completionHandler:NULL];

website/docs/share-single.mdx

@@ -142,8 +142,28 @@ await Share.shareSingle({
     });
 ```
 
-**Note:** Your app's user must accept "All Photos" when prompted about photo permissions otherwise they may get a "Something went wrong" error.
-
+**Warning!**
+To be able to use this feature, your app's user must accept "All Photos" when prompted about photo permissions,
+but first you need to add following permissions to your `Info.plist`:
+```xml
+<key>NSPhotoLibraryUsageDescription</key>
+<string>This app requires access to the photo library to save and share images on Instagram.</string>
+<key>NSPhotoLibraryAddUsageDescription</key>
+<string>This app requires access to the photo library to save and share images on Instagram.</string>
+```
+Or if you're using expo you can add them to `app.json` / `app.config.ts`:
+```typescript
+expo: {
+    ios: {
+        infoPlist: {
+            NSPhotoLibraryUsageDescription:
+              'This app requires access to the photo library to save and share images on Instagram',
+            NSPhotoLibraryAddUsageDescription:
+              'This app requires access to the photo library to save and share images on Instagram.',
+        },
+    }
+}
+```
 
 ### Share remote videos to Instagram
 Instagram tries to select **the very last file of the cameraroll** so you have to save videos to the cameraroll in case you want to share them to Instagram.
@@ -175,7 +195,7 @@ By default IG opens New post view with Camera View. There you can find also stor
 import Share from 'react-native-share';
 
 const shareOptions = {
-    url: 'instagram://camera', 
+    url: 'instagram://camera',
     social: Share.Social.INSTAGRAM
 };
 
@@ -187,14 +207,14 @@ Share.shareSingle(shareOptions);
 import Share from 'react-native-share';
 
 const shareOptions = {
-    url: 'instagram://share', 
+    url: 'instagram://share',
     social: Share.Social.INSTAGRAM
 };
 
 Share.shareSingle(shareOptions);
 ```
 
-URL patterns like `instagram://` can be used on Android, but works different then documented for IOS 
+URL patterns like `instagram://` can be used on Android, but works different then documented for IOS
 https://developers.facebook.com/docs/instagram/sharing-to-feed/