Added .lottieResourcePath context and coder options, don't use NSBundle to make it more general (such as load it from sandbox)

Author: dreampiggy

README.md

@@ -149,6 +149,28 @@ let pixelSize = CGSize(width: 300, height: 300)
 imageView.sd_setImage(with: lottieURL, placeholderImage: nil, options: [], contrext: [.thumbnailPixelSize : pixelSize])
 ```
 
+### Decoding
+
+You can decode lottie image into aniamted UIImage/NSImage as well. If the lottie images have [referenced external image resource](https://airbnb.io/lottie/#/supported-features), you can specify it as well.
+
++ Objective-C
+
+```objective-c
+// Lottie image decoding
+NSData *lottieJSONData;
+NSBundle *imageBundle; // You can even download the external image from online to local path, then load the lottie animation
+UIImage *image = [[SDImageLottieCoder sharedCoder] decodedImageWithData:lottieJSONData options:@{SDImageCoderDecodeLottieResourcePath : imageBundle.resourcePath}];
+```
+
++ Swift
+
+```swift
+// Lottie image decoding
+let lottieJSONData: Data
+let imageBundle: Bundle // You can even download the external image from online to local path, then load the lottie animation
+let image = SDImageWebPCoder.shared.decodedImage(with: lottieJSONData, options: [.lottieResourcePath : imageBundle.resourcePath])
+```
+
 ## Screenshot
 
 <img src="https://raw.githubusercontent.com/SDWebImage/SDWebImageLottieCoder/master/Example/Screenshot/LottieDemo.gif" width="300" />

SDWebImageLottieCoder/Classes/SDImageLottieCoder.m

@@ -7,6 +7,7 @@
 */
 
 #import "SDImageLottieCoder.h"
+#import "SDWebImageLottieLoaderDefine.h"
 #if __has_include(<rlottie/rlottie_capi.h>)
 #import <rlottie/rlottie_capi.h>
 #elif __has_include(<librlottie/librlottie.h>)
@@ -118,11 +119,17 @@ - (UIImage *)decodedImageWithData:(NSData *)data options:(SDImageCoderOptions *)
     if (preserveAspectRatioValue != nil) {
         preserveAspectRatio = preserveAspectRatioValue.boolValue;
     }
-    NSBundle *bundle = NSBundle.mainBundle;
-    const char *resourcePath = [bundle.resourcePath cStringUsingEncoding:NSUTF8StringEncoding];
+    NSString *resourcePath = NSBundle.mainBundle.resourcePath;
+    SDWebImageContext *context = options[SDImageCoderWebImageContext];
+    if (context[SDWebImageContextLottieResourcePath]) {
+        resourcePath = context[SDWebImageContextLottieResourcePath];
+    } else if (options[SDImageCoderDecodeLottieResourcePath]) {
+        resourcePath = options[SDImageCoderDecodeLottieResourcePath];
+    }
     NSString *jsonString = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
-    const char *jsonData = [jsonString cStringUsingEncoding:NSUTF8StringEncoding];
-    Lottie_Animation *animation = lottie_animation_from_data(jsonData, "", resourcePath);
+    const char *jsonDataBuffer = [jsonString cStringUsingEncoding:NSUTF8StringEncoding];
+    const char *resourcePathBuffer = [resourcePath cStringUsingEncoding:NSUTF8StringEncoding];
+    Lottie_Animation *animation = lottie_animation_from_data(jsonDataBuffer, "", resourcePathBuffer);
     if (!animation) {
         return nil;
     }
@@ -200,11 +207,17 @@ - (NSData *)encodedDataWithImage:(UIImage *)image format:(SDImageFormat)format o
 - (instancetype)initWithAnimatedImageData:(NSData *)data options:(SDImageCoderOptions *)options {
     self = [super init];
     if (self) {
-        NSBundle *bundle = NSBundle.mainBundle;
-        const char *resourcePath = [bundle.resourcePath cStringUsingEncoding:NSUTF8StringEncoding];
+        NSString *resourcePath = NSBundle.mainBundle.resourcePath;
+        SDWebImageContext *context = options[SDImageCoderWebImageContext];
+        if (context[SDWebImageContextLottieResourcePath]) {
+            resourcePath = context[SDWebImageContextLottieResourcePath];
+        } else if (options[SDImageCoderDecodeLottieResourcePath]) {
+            resourcePath = options[SDImageCoderDecodeLottieResourcePath];
+        }
         NSString *jsonString = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
-        const char *jsonData = [jsonString cStringUsingEncoding:NSUTF8StringEncoding];
-        Lottie_Animation *animation = lottie_animation_from_data(jsonData, "", resourcePath);
+        const char *jsonDataBuffer = [jsonString cStringUsingEncoding:NSUTF8StringEncoding];
+        const char *resourcePathBuffer = [resourcePath cStringUsingEncoding:NSUTF8StringEncoding];
+        Lottie_Animation *animation = lottie_animation_from_data(jsonDataBuffer, "", resourcePathBuffer);
         if (!animation) {
             return nil;
         }

SDWebImageLottieCoder/Classes/SDWebImageLottieLoaderDefine.h

@@ -0,0 +1,27 @@
+/*
+* This file is part of the SDWebImage package.
+* (c) DreamPiggy <lizhuoli1126@126.com>
+*
+* For the full copyright and license information, please view the LICENSE
+* file that was distributed with this source code.
+*/
+
+#if __has_include(<SDWebImage/SDWebImage.h>)
+#import <SDWebImage/SDWebImage.h>
+#else
+@import SDWebImage;
+#endif
+
+/**
+ * The asset resource path used for lottie animation to load bitmap images in the animation. If you don't provide this context option, use main bundle's resource path instead.
+ * Defaults to nil, means main bundle's resource path. (NSString)
+ */
+FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextLottieResourcePath;
+
+#pragma mark - Coder Options
+
+/**
+ * The asset resource path used for lottie animation to load bitmap images in the animation. If you don't provide this context option, use main bundle's resource path instead.
+ * Defaults to nil, means main bundle's resource path. (NSString)
+*/
+FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderDecodeLottieResourcePath;

SDWebImageLottieCoder/Classes/SDWebImageLottieLoaderDefine.m

@@ -0,0 +1,13 @@
+/*
+* This file is part of the SDWebImage package.
+* (c) DreamPiggy <lizhuoli1126@126.com>
+*
+* For the full copyright and license information, please view the LICENSE
+* file that was distributed with this source code.
+*/
+
+#import "SDWebImageLottieLoaderDefine.h"
+
+SDWebImageContextOption _Nonnull const SDWebImageContextLottieResourcePath = @"lottieResourcePath";
+
+SDImageCoderOption _Nonnull const SDImageCoderDecodeLottieResourcePath = @"decodeLottieResourcePath";