react-native-fast-image 8.5.12 → 8.6.0

package/README.md

@@ -143,6 +143,13 @@ Headers to load the image with. e.g. `{ Authorization: 'someAuthToken' }`.
 
 ---
 
+### `defaultSource?: number`
+
+-   An asset loaded with `require(...)`.
+-   Note that like the built-in `Image` implementation, on Android `defaultSource` does not work in debug mode. This is due to the fact that assets are sent from the dev server, but RN's functions only know how to load it from `res`.
+
+---
+
 ### `resizeMode?: enum`
 
 -   `FastImage.resizeMode.contain` - Scale the image uniformly (maintain the image's aspect ratio) so that both dimensions (width and height) of the image will be equal to or less than the corresponding dimension of the view (minus padding).

package/android/src/main/java/com/dylanvann/fastimage/FastImageOkHttpProgressGlideModule.java

@@ -32,7 +32,7 @@ import okio.Source;
 @GlideModule
 public class FastImageOkHttpProgressGlideModule extends LibraryGlideModule {
 
-    private static DispatchingProgressListener progressListener = new DispatchingProgressListener();
+    private static final DispatchingProgressListener progressListener = new DispatchingProgressListener();
 
     @Override
     public void registerComponents(

package/android/src/main/java/com/dylanvann/fastimage/FastImageRequestListener.java

@@ -16,8 +16,7 @@ public class FastImageRequestListener implements RequestListener<Drawable> {
     static final String REACT_ON_ERROR_EVENT = "onFastImageError";
     static final String REACT_ON_LOAD_EVENT = "onFastImageLoad";
     static final String REACT_ON_LOAD_END_EVENT = "onFastImageLoadEnd";
-
-    private String key;
+    private final String key;
 
     FastImageRequestListener(String key) {
         this.key = key;

package/android/src/main/java/com/dylanvann/fastimage/FastImageSource.java

@@ -17,7 +17,7 @@ public class FastImageSource extends ImageSource {
     private static final String ANDROID_RESOURCE_SCHEME = "android.resource";
     private static final String ANDROID_CONTENT_SCHEME = "content";
     private static final String LOCAL_FILE_SCHEME = "file";
-    private Headers mHeaders;
+    private final Headers mHeaders;
     private Uri mUri;
 
     public static boolean isBase64Uri(Uri uri) {

package/android/src/main/java/com/dylanvann/fastimage/FastImageViewConverter.java

@@ -1,18 +1,16 @@
 package com.dylanvann.fastimage;
 
+import static com.bumptech.glide.request.RequestOptions.signatureOf;
+
 import android.content.Context;
 import android.graphics.Color;
 import android.graphics.drawable.ColorDrawable;
 import android.graphics.drawable.Drawable;
-import android.media.Image;
-import android.net.Uri;
-import android.util.Log;
 import android.widget.ImageView;
 import android.widget.ImageView.ScaleType;
 
 import com.bumptech.glide.Priority;
 import com.bumptech.glide.load.engine.DiskCacheStrategy;
-import com.bumptech.glide.load.model.GlideUrl;
 import com.bumptech.glide.load.model.Headers;
 import com.bumptech.glide.load.model.LazyHeaders;
 import com.bumptech.glide.request.RequestOptions;
@@ -21,18 +19,12 @@ import com.facebook.react.bridge.JSApplicationIllegalArgumentException;
 import com.facebook.react.bridge.NoSuchKeyException;
 import com.facebook.react.bridge.ReadableMap;
 import com.facebook.react.bridge.ReadableMapKeySetIterator;
-import com.facebook.react.views.imagehelper.ImageSource;
 
-import java.io.File;
-import java.net.URI;
-import java.net.URISyntaxException;
 import java.util.HashMap;
 import java.util.Map;
 
 import javax.annotation.Nullable;
 
-import static com.bumptech.glide.request.RequestOptions.signatureOf;
-
 class FastImageViewConverter {
     private static final Drawable TRANSPARENT_DRAWABLE = new ColorDrawable(Color.TRANSPARENT);
 
@@ -57,10 +49,13 @@ class FastImageViewConverter {
                 put("stretch", ScaleType.FIT_XY);
                 put("center", ScaleType.CENTER_INSIDE);
             }};
-    
+
     // Resolve the source uri to a file path that android understands.
-    static FastImageSource getImageSource(Context context, ReadableMap source) {
-        return new FastImageSource(context, source.getString("uri"), getHeaders(source));
+    static @Nullable
+    FastImageSource getImageSource(Context context, @Nullable ReadableMap source) {
+        return source == null
+                ? null
+                : new FastImageSource(context, source.getString("uri"), getHeaders(source));
     }
 
     static Headers getHeaders(ReadableMap source) {
@@ -90,8 +85,8 @@ class FastImageViewConverter {
         // Get cache control method.
         final FastImageCacheControl cacheControl = FastImageViewConverter.getCacheControl(source);
         DiskCacheStrategy diskCacheStrategy = DiskCacheStrategy.AUTOMATIC;
-        Boolean onlyFromCache = false;
-        Boolean skipMemoryCache = false;
+        boolean onlyFromCache = false;
+        boolean skipMemoryCache = false;
         switch (cacheControl) {
             case WEB:
                 // If using none then OkHttp integration should be used for caching.
@@ -107,12 +102,12 @@ class FastImageViewConverter {
         }
 
         RequestOptions options = new RequestOptions()
-            .diskCacheStrategy(diskCacheStrategy)
-            .onlyRetrieveFromCache(onlyFromCache)
-            .skipMemoryCache(skipMemoryCache)
-            .priority(priority)
-            .placeholder(TRANSPARENT_DRAWABLE);
-        
+                .diskCacheStrategy(diskCacheStrategy)
+                .onlyRetrieveFromCache(onlyFromCache)
+                .skipMemoryCache(skipMemoryCache)
+                .priority(priority)
+                .placeholder(TRANSPARENT_DRAWABLE);
+
         if (imageSource.isResource()) {
             // Every local resource (drawable) in Android has its own unique numeric id, which are
             // generated at build time. Although these ids are unique, they are not guaranteed unique
@@ -123,7 +118,7 @@ class FastImageViewConverter {
             options = options.apply(signatureOf(ApplicationVersionSignature.obtain(context)));
         }
 
-        return options;                
+        return options;
     }
 
     private static FastImageCacheControl getCacheControl(ReadableMap source) {

package/android/src/main/java/com/dylanvann/fastimage/FastImageViewManager.java

@@ -1,15 +1,19 @@
 package com.dylanvann.fastimage;
 
+import static com.dylanvann.fastimage.FastImageRequestListener.REACT_ON_ERROR_EVENT;
+import static com.dylanvann.fastimage.FastImageRequestListener.REACT_ON_LOAD_END_EVENT;
+import static com.dylanvann.fastimage.FastImageRequestListener.REACT_ON_LOAD_EVENT;
+
 import android.app.Activity;
 import android.content.Context;
 import android.content.ContextWrapper;
 import android.graphics.PorterDuff;
 import android.os.Build;
 
+import androidx.annotation.NonNull;
+
 import com.bumptech.glide.Glide;
 import com.bumptech.glide.RequestManager;
-import com.bumptech.glide.load.model.GlideUrl;
-import com.bumptech.glide.request.Request;
 import com.facebook.react.bridge.ReadableMap;
 import com.facebook.react.bridge.WritableMap;
 import com.facebook.react.bridge.WritableNativeMap;
@@ -18,36 +22,33 @@ import com.facebook.react.uimanager.SimpleViewManager;
 import com.facebook.react.uimanager.ThemedReactContext;
 import com.facebook.react.uimanager.annotations.ReactProp;
 import com.facebook.react.uimanager.events.RCTEventEmitter;
+import com.facebook.react.views.imagehelper.ResourceDrawableIdHelper;
 
-import java.util.ArrayList;
-import java.util.Collections;
 import java.util.List;
 import java.util.Map;
 import java.util.WeakHashMap;
 
 import javax.annotation.Nullable;
 
-import static com.dylanvann.fastimage.FastImageRequestListener.REACT_ON_ERROR_EVENT;
-import static com.dylanvann.fastimage.FastImageRequestListener.REACT_ON_LOAD_END_EVENT;
-import static com.dylanvann.fastimage.FastImageRequestListener.REACT_ON_LOAD_EVENT;
-
 class FastImageViewManager extends SimpleViewManager<FastImageViewWithUrl> implements FastImageProgressListener {
 
-    private static final String REACT_CLASS = "FastImageView";
-    private static final String REACT_ON_LOAD_START_EVENT = "onFastImageLoadStart";
-    private static final String REACT_ON_PROGRESS_EVENT = "onFastImageProgress";
+    static final String REACT_CLASS = "FastImageView";
+    static final String REACT_ON_LOAD_START_EVENT = "onFastImageLoadStart";
+    static final String REACT_ON_PROGRESS_EVENT = "onFastImageProgress";
     private static final Map<String, List<FastImageViewWithUrl>> VIEWS_FOR_URLS = new WeakHashMap<>();
 
     @Nullable
     private RequestManager requestManager = null;
 
+    @NonNull
     @Override
     public String getName() {
         return REACT_CLASS;
     }
 
+    @NonNull
     @Override
-    protected FastImageViewWithUrl createViewInstance(ThemedReactContext reactContext) {
+    protected FastImageViewWithUrl createViewInstance(@NonNull ThemedReactContext reactContext) {
         if (isValidContextForGlide(reactContext)) {
             requestManager = Glide.with(reactContext);
         }
@@ -56,76 +57,15 @@ class FastImageViewManager extends SimpleViewManager<FastImageViewWithUrl> imple
     }
 
     @ReactProp(name = "source")
-    public void setSrc(FastImageViewWithUrl view, @Nullable ReadableMap source) {
-        if (source == null || !source.hasKey("uri") || isNullOrEmpty(source.getString("uri"))) {
-            // Cancel existing requests.
-            clearView(view);
-
-            if (view.glideUrl != null) {
-                FastImageOkHttpProgressGlideModule.forget(view.glideUrl.toStringUrl());
-            }
-            // Clear the image.
-            view.setImageDrawable(null);
-            return;
-        }
-
-        //final GlideUrl glideUrl = FastImageViewConverter.getGlideUrl(view.getContext(), source);
-        final FastImageSource imageSource = FastImageViewConverter.getImageSource(view.getContext(), source);
-        if (imageSource.getUri().toString().length() == 0) {
-            ThemedReactContext context = (ThemedReactContext) view.getContext();
-            RCTEventEmitter eventEmitter = context.getJSModule(RCTEventEmitter.class);
-            int viewId = view.getId();
-            WritableMap event = new WritableNativeMap();
-            event.putString("message", "Invalid source prop:" + source);
-            eventEmitter.receiveEvent(viewId, REACT_ON_ERROR_EVENT, event);
-
-            // Cancel existing requests.
-            if (requestManager != null) {
-                requestManager.clear(view);
-            }
-
-            if (view.glideUrl != null) {
-                FastImageOkHttpProgressGlideModule.forget(view.glideUrl.toStringUrl());
-            }
-            // Clear the image.
-            view.setImageDrawable(null);
-            return;
-        }
-
-        final GlideUrl glideUrl = imageSource.getGlideUrl();
-
-        // Cancel existing request.
-        view.glideUrl = glideUrl;
-        clearView(view);
-
-        String key = glideUrl.toStringUrl();
-        FastImageOkHttpProgressGlideModule.expect(key, this);
-        List<FastImageViewWithUrl> viewsForKey = VIEWS_FOR_URLS.get(key);
-        if (viewsForKey != null && !viewsForKey.contains(view)) {
-            viewsForKey.add(view);
-        } else if (viewsForKey == null) {
-            List<FastImageViewWithUrl> newViewsForKeys = new ArrayList<>(Collections.singletonList(view));
-            VIEWS_FOR_URLS.put(key, newViewsForKeys);
-        }
+    public void setSource(FastImageViewWithUrl view, @Nullable ReadableMap source) {
+        view.setSource(source);
+    }
 
-        ThemedReactContext context = (ThemedReactContext) view.getContext();
-        RCTEventEmitter eventEmitter = context.getJSModule(RCTEventEmitter.class);
-        int viewId = view.getId();
-        eventEmitter.receiveEvent(viewId, REACT_ON_LOAD_START_EVENT, new WritableNativeMap());
-
-        if (requestManager != null) {
-            requestManager
-                    // This will make this work for remote and local images. e.g.
-                    //    - file:///
-                    //    - content://
-                    //    - res:/
-                    //    - android.resource://
-                    //    - data:image/png;base64
-                    .load(imageSource.getSourceForLoad())
-                    .apply(FastImageViewConverter.getOptions(context, imageSource, source))
-                    .listener(new FastImageRequestListener(key))
-                    .into(view);
-        }
+    @ReactProp(name = "defaultSource")
+    public void setDefaultSource(FastImageViewWithUrl view, @Nullable String source) {
+        view.setDefaultSource(
+                ResourceDrawableIdHelper.getInstance()
+                        .getResourceDrawable(view.getContext(), source));
     }
 
     @ReactProp(name = "tintColor", customType = "Color")
@@ -144,9 +84,9 @@ class FastImageViewManager extends SimpleViewManager<FastImageViewWithUrl> imple
     }
 
     @Override
-    public void onDropViewInstance(FastImageViewWithUrl view) {
+    public void onDropViewInstance(@NonNull FastImageViewWithUrl view) {
         // This will cancel existing requests.
-        clearView(view);
+        view.clearView(requestManager);
 
         if (view.glideUrl != null) {
             final String key = view.glideUrl.toString();
@@ -193,11 +133,6 @@ class FastImageViewManager extends SimpleViewManager<FastImageViewWithUrl> imple
         return 0.5f;
     }
 
-    private boolean isNullOrEmpty(final String url) {
-        return url == null || url.trim().isEmpty();
-    }
-
-
     private static boolean isValidContextForGlide(final Context context) {
         Activity activity = getActivityFromContext(context);
 
@@ -235,14 +170,14 @@ class FastImageViewManager extends SimpleViewManager<FastImageViewWithUrl> imple
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1) {
             return activity.isDestroyed() || activity.isFinishing();
         } else {
-            return activity.isDestroyed() || activity.isFinishing() || activity.isChangingConfigurations();
+            return activity.isFinishing() || activity.isChangingConfigurations();
         }
 
     }
 
-    private void clearView(FastImageViewWithUrl view) {
-        if (requestManager != null && view != null && view.getTag() != null && view.getTag() instanceof Request) {
-            requestManager.clear(view);
-        }
+    @Override
+    protected void onAfterUpdateTransaction(@NonNull FastImageViewWithUrl view) {
+        super.onAfterUpdateTransaction(view);
+        view.onAfterUpdate(this, requestManager, VIEWS_FOR_URLS);
     }
 }

package/android/src/main/java/com/dylanvann/fastimage/FastImageViewModule.java

@@ -2,6 +2,8 @@ package com.dylanvann.fastimage;
 
 import android.app.Activity;
 
+import androidx.annotation.NonNull;
+
 import com.bumptech.glide.Glide;
 import com.bumptech.glide.load.model.GlideUrl;
 import com.facebook.react.bridge.Promise;
@@ -20,6 +22,7 @@ class FastImageViewModule extends ReactContextBaseJavaModule {
         super(reactContext);
     }
 
+    @NonNull
     @Override
     public String getName() {
         return REACT_CLASS;

package/android/src/main/java/com/dylanvann/fastimage/FastImageViewPackage.java

@@ -1,5 +1,7 @@
 package com.dylanvann.fastimage;
 
+import androidx.annotation.NonNull;
+
 import com.facebook.react.ReactPackage;
 import com.facebook.react.bridge.NativeModule;
 import com.facebook.react.bridge.ReactApplicationContext;
@@ -9,13 +11,15 @@ import java.util.Collections;
 import java.util.List;
 
 public class FastImageViewPackage implements ReactPackage {
+    @NonNull
     @Override
-    public List<NativeModule> createNativeModules(ReactApplicationContext reactContext) {
+    public List<NativeModule> createNativeModules(@NonNull ReactApplicationContext reactContext) {
         return Collections.<NativeModule>singletonList(new FastImageViewModule(reactContext));
     }
 
+    @NonNull
     @Override
-    public List<ViewManager> createViewManagers(ReactApplicationContext reactContext) {
+    public List<ViewManager> createViewManagers(@NonNull ReactApplicationContext reactContext) {
         return Collections.<ViewManager>singletonList(new FastImageViewManager());
     }
 }

package/android/src/main/java/com/dylanvann/fastimage/FastImageViewWithUrl.java

@@ -1,15 +1,159 @@
 package com.dylanvann.fastimage;
 
+import static com.dylanvann.fastimage.FastImageRequestListener.REACT_ON_ERROR_EVENT;
+
+import android.annotation.SuppressLint;
 import android.content.Context;
+import android.graphics.drawable.Drawable;
 
+import androidx.annotation.Nullable;
 import androidx.appcompat.widget.AppCompatImageView;
 
+import com.bumptech.glide.RequestBuilder;
+import com.bumptech.glide.RequestManager;
 import com.bumptech.glide.load.model.GlideUrl;
+import com.bumptech.glide.request.Request;
+import com.facebook.react.bridge.ReadableMap;
+import com.facebook.react.bridge.WritableMap;
+import com.facebook.react.bridge.WritableNativeMap;
+import com.facebook.react.uimanager.ThemedReactContext;
+import com.facebook.react.uimanager.events.RCTEventEmitter;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import javax.annotation.Nonnull;
 
 class FastImageViewWithUrl extends AppCompatImageView {
+    private boolean mNeedsReload = false;
+    private ReadableMap mSource = null;
+    private Drawable mDefaultSource = null;
+
     public GlideUrl glideUrl;
 
     public FastImageViewWithUrl(Context context) {
         super(context);
     }
+
+    public void setSource(@Nullable ReadableMap source) {
+        mNeedsReload = true;
+        mSource = source;
+    }
+
+    public void setDefaultSource(@Nullable Drawable source) {
+        mNeedsReload = true;
+        mDefaultSource = source;
+    }
+
+    private boolean isNullOrEmpty(final String url) {
+        return url == null || url.trim().isEmpty();
+    }
+
+    @SuppressLint("CheckResult")
+    public void onAfterUpdate(
+            @Nonnull FastImageViewManager manager,
+            @Nullable RequestManager requestManager,
+            @Nonnull Map<String, List<FastImageViewWithUrl>> viewsForUrlsMap) {
+        if (!mNeedsReload)
+            return;
+
+        if ((mSource == null ||
+                !mSource.hasKey("uri") ||
+                isNullOrEmpty(mSource.getString("uri"))) &&
+                mDefaultSource == null) {
+
+            // Cancel existing requests.
+            clearView(requestManager);
+
+            if (glideUrl != null) {
+                FastImageOkHttpProgressGlideModule.forget(glideUrl.toStringUrl());
+            }
+
+            // Clear the image.
+            setImageDrawable(null);
+            return;
+        }
+
+        //final GlideUrl glideUrl = FastImageViewConverter.getGlideUrl(view.getContext(), mSource);
+        final FastImageSource imageSource = FastImageViewConverter.getImageSource(getContext(), mSource);
+
+        if (imageSource != null && imageSource.getUri().toString().length() == 0) {
+            ThemedReactContext context = (ThemedReactContext) getContext();
+            RCTEventEmitter eventEmitter = context.getJSModule(RCTEventEmitter.class);
+            int viewId = getId();
+            WritableMap event = new WritableNativeMap();
+            event.putString("message", "Invalid source prop:" + mSource);
+            eventEmitter.receiveEvent(viewId, REACT_ON_ERROR_EVENT, event);
+
+            // Cancel existing requests.
+            clearView(requestManager);
+
+            if (glideUrl != null) {
+                FastImageOkHttpProgressGlideModule.forget(glideUrl.toStringUrl());
+            }
+            // Clear the image.
+            setImageDrawable(null);
+            return;
+        }
+
+        // `imageSource` may be null and we still continue, if `defaultSource` is not null
+        final GlideUrl glideUrl = imageSource == null ? null : imageSource.getGlideUrl();
+
+        // Cancel existing request.
+        this.glideUrl = glideUrl;
+        clearView(requestManager);
+
+        String key = glideUrl == null ? null : glideUrl.toStringUrl();
+
+        if (glideUrl != null) {
+            FastImageOkHttpProgressGlideModule.expect(key, manager);
+            List<FastImageViewWithUrl> viewsForKey = viewsForUrlsMap.get(key);
+            if (viewsForKey != null && !viewsForKey.contains(this)) {
+                viewsForKey.add(this);
+            } else if (viewsForKey == null) {
+                List<FastImageViewWithUrl> newViewsForKeys = new ArrayList<>(Collections.singletonList(this));
+                viewsForUrlsMap.put(key, newViewsForKeys);
+            }
+        }
+
+        ThemedReactContext context = (ThemedReactContext) getContext();
+        if (imageSource != null) {
+            // This is an orphan even without a load/loadend when only loading a placeholder
+            RCTEventEmitter eventEmitter = context.getJSModule(RCTEventEmitter.class);
+            int viewId = this.getId();
+
+            eventEmitter.receiveEvent(viewId,
+                    FastImageViewManager.REACT_ON_LOAD_START_EVENT,
+                    new WritableNativeMap());
+        }
+
+        if (requestManager != null) {
+            RequestBuilder<Drawable> builder =
+                    requestManager
+                            // This will make this work for remote and local images. e.g.
+                            //    - file:///
+                            //    - content://
+                            //    - res:/
+                            //    - android.resource://
+                            //    - data:image/png;base64
+                            .load(imageSource == null ? null : imageSource.getSourceForLoad())
+                            .apply(FastImageViewConverter
+                                    .getOptions(context, imageSource, mSource)
+                                    .placeholder(mDefaultSource) // show until loaded
+                                    .fallback(mDefaultSource)); // null will not be treated as error
+
+            if (key != null)
+                builder.listener(new FastImageRequestListener(key));
+
+            builder.into(this);
+        }
+    }
+
+    public void clearView(@Nullable RequestManager requestManager) {
+        if (requestManager != null && getTag() != null && getTag() instanceof Request) {
+            requestManager.clear(this);
+        }
+    }
 }

package/dist/index.cjs.js

@@ -9,7 +9,6 @@ function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'defau
 var _extends__default = /*#__PURE__*/_interopDefaultLegacy(_extends);
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 
-const FastImageViewNativeModule = reactNative.NativeModules.FastImageView;
 const resizeMode = {
   contain: 'contain',
   cover: 'cover',
@@ -30,8 +29,30 @@ const cacheControl = {
   cacheOnly: 'cacheOnly'
 };
 
+const resolveDefaultSource = defaultSource => {
+  if (!defaultSource) {
+    return null;
+  }
+
+  if (reactNative.Platform.OS === 'android') {
+    // Android receives a URI string, and resolves into a Drawable using RN's methods.
+    const resolved = reactNative.Image.resolveAssetSource(defaultSource);
+
+    if (resolved) {
+      return resolved.uri;
+    }
+
+    return null;
+  } // iOS or other number mapped assets
+  // In iOS the number is passed, and bridged automatically into a UIImage
+
+
+  return defaultSource;
+};
+
 function FastImageBase({
   source,
+  defaultSource,
   tintColor,
   onLoadStart,
   onProgress,
@@ -57,6 +78,7 @@ function FastImageBase({
     }, /*#__PURE__*/React__default['default'].createElement(reactNative.Image, _extends__default['default']({}, props, {
       style: reactNative.StyleSheet.absoluteFill,
       source: resolvedSource,
+      defaultSource: defaultSource,
       onLoadStart: onLoadStart,
       onProgress: onProgress,
       onLoad: onLoad,
@@ -67,6 +89,7 @@ function FastImageBase({
   }
 
   const resolvedSource = reactNative.Image.resolveAssetSource(source);
+  const resolvedDefaultSource = resolveDefaultSource(defaultSource);
   return /*#__PURE__*/React__default['default'].createElement(reactNative.View, {
     style: [styles.imageContainer, style],
     ref: forwardedRef
@@ -74,6 +97,7 @@ function FastImageBase({
     tintColor: tintColor,
     style: reactNative.StyleSheet.absoluteFill,
     source: resolvedSource,
+    defaultSource: resolvedDefaultSource,
     onFastImageLoadStart: onLoadStart,
     onFastImageProgress: onProgress,
     onFastImageLoad: onLoad,
@@ -93,11 +117,11 @@ FastImage.resizeMode = resizeMode;
 FastImage.cacheControl = cacheControl;
 FastImage.priority = priority;
 
-FastImage.preload = sources => FastImageViewNativeModule.preload(sources);
+FastImage.preload = sources => reactNative.NativeModules.FastImageView.preload(sources);
 
-FastImage.clearMemoryCache = () => FastImageViewNativeModule.clearMemoryCache();
+FastImage.clearMemoryCache = () => reactNative.NativeModules.FastImageView.clearMemoryCache();
 
-FastImage.clearDiskCache = () => FastImageViewNativeModule.clearDiskCache();
+FastImage.clearDiskCache = () => reactNative.NativeModules.FastImageView.clearDiskCache();
 
 const styles = reactNative.StyleSheet.create({
   imageContainer: {

package/dist/index.cjs.js.flow

@@ -56,7 +56,8 @@ export type FastImageProps = $ReadOnly<{|
     onLoadStart?: ?() => void,
     onProgress?: ?(event: OnProgressEvent) => void,
 
-    source: FastImageSource | number,
+    source?: ?(FastImageSource | number),
+    defaultSource?: ?number
 
     resizeMode?: ?ResizeModes,
     fallback?: ?boolean,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { FlexStyle, LayoutChangeEvent, ShadowStyleIOS, StyleProp, TransformsStyle, AccessibilityProps, ViewProps } from 'react-native';
+import { FlexStyle, LayoutChangeEvent, ShadowStyleIOS, StyleProp, TransformsStyle, ImageRequireSource, AccessibilityProps, ViewProps } from 'react-native';
 export declare type ResizeMode = 'contain' | 'cover' | 'stretch' | 'center';
 declare const resizeMode: {
     readonly contain: "contain";
@@ -54,7 +54,8 @@ export interface ImageStyle extends FlexStyle, TransformsStyle, ShadowStyleIOS {
     opacity?: number;
 }
 export interface FastImageProps extends AccessibilityProps, ViewProps {
-    source: Source | number;
+    source?: Source | ImageRequireSource;
+    defaultSource?: ImageRequireSource;
     resizeMode?: ResizeMode;
     fallback?: boolean;
     onLoadStart?(): void;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,8 +1,7 @@
 import _extends from '@babel/runtime/helpers/extends';
 import React, { forwardRef, memo } from 'react';
-import { NativeModules, StyleSheet, requireNativeComponent, Image, View } from 'react-native';
+import { NativeModules, StyleSheet, requireNativeComponent, Image, View, Platform } from 'react-native';
 
-const FastImageViewNativeModule = NativeModules.FastImageView;
 const resizeMode = {
   contain: 'contain',
   cover: 'cover',
@@ -23,8 +22,30 @@ const cacheControl = {
   cacheOnly: 'cacheOnly'
 };
 
+const resolveDefaultSource = defaultSource => {
+  if (!defaultSource) {
+    return null;
+  }
+
+  if (Platform.OS === 'android') {
+    // Android receives a URI string, and resolves into a Drawable using RN's methods.
+    const resolved = Image.resolveAssetSource(defaultSource);
+
+    if (resolved) {
+      return resolved.uri;
+    }
+
+    return null;
+  } // iOS or other number mapped assets
+  // In iOS the number is passed, and bridged automatically into a UIImage
+
+
+  return defaultSource;
+};
+
 function FastImageBase({
   source,
+  defaultSource,
   tintColor,
   onLoadStart,
   onProgress,
@@ -50,6 +71,7 @@ function FastImageBase({
     }, /*#__PURE__*/React.createElement(Image, _extends({}, props, {
       style: StyleSheet.absoluteFill,
       source: resolvedSource,
+      defaultSource: defaultSource,
       onLoadStart: onLoadStart,
       onProgress: onProgress,
       onLoad: onLoad,
@@ -60,6 +82,7 @@ function FastImageBase({
   }
 
   const resolvedSource = Image.resolveAssetSource(source);
+  const resolvedDefaultSource = resolveDefaultSource(defaultSource);
   return /*#__PURE__*/React.createElement(View, {
     style: [styles.imageContainer, style],
     ref: forwardedRef
@@ -67,6 +90,7 @@ function FastImageBase({
     tintColor: tintColor,
     style: StyleSheet.absoluteFill,
     source: resolvedSource,
+    defaultSource: resolvedDefaultSource,
     onFastImageLoadStart: onLoadStart,
     onFastImageProgress: onProgress,
     onFastImageLoad: onLoad,
@@ -86,11 +110,11 @@ FastImage.resizeMode = resizeMode;
 FastImage.cacheControl = cacheControl;
 FastImage.priority = priority;
 
-FastImage.preload = sources => FastImageViewNativeModule.preload(sources);
+FastImage.preload = sources => NativeModules.FastImageView.preload(sources);
 
-FastImage.clearMemoryCache = () => FastImageViewNativeModule.clearMemoryCache();
+FastImage.clearMemoryCache = () => NativeModules.FastImageView.clearMemoryCache();
 
-FastImage.clearDiskCache = () => FastImageViewNativeModule.clearDiskCache();
+FastImage.clearDiskCache = () => NativeModules.FastImageView.clearDiskCache();
 
 const styles = StyleSheet.create({
   imageContainer: {

package/dist/index.js.flow

@@ -56,7 +56,8 @@ export type FastImageProps = $ReadOnly<{|
     onLoadStart?: ?() => void,
     onProgress?: ?(event: OnProgressEvent) => void,
 
-    source: FastImageSource | number,
+    source?: ?(FastImageSource | number),
+    defaultSource?: ?number
 
     resizeMode?: ?ResizeModes,
     fallback?: ?boolean,

package/ios/FastImage/FFFastImageView.h

@@ -17,6 +17,7 @@
 @property (nonatomic, copy) RCTDirectEventBlock onFastImageLoadEnd;
 @property (nonatomic, assign) RCTResizeMode resizeMode;
 @property (nonatomic, strong) FFFastImageSource *source;
+@property (nonatomic, strong) UIImage *defaultSource;
 @property (nonatomic, strong) UIColor *imageColor;
 
 @end

package/ios/FastImage/FFFastImageView.m

@@ -2,15 +2,15 @@
 #import <SDWebImage/UIImage+MultiFormat.h>
 #import <SDWebImage/UIView+WebCache.h>
 
-@interface FFFastImageView()
+@interface FFFastImageView ()
 
-@property (nonatomic, assign) BOOL hasSentOnLoadStart;
-@property (nonatomic, assign) BOOL hasCompleted;
-@property (nonatomic, assign) BOOL hasErrored;
+@property(nonatomic, assign) BOOL hasSentOnLoadStart;
+@property(nonatomic, assign) BOOL hasCompleted;
+@property(nonatomic, assign) BOOL hasErrored;
 // Whether the latest change of props requires the image to be reloaded
-@property (nonatomic, assign) BOOL needsReload;
+@property(nonatomic, assign) BOOL needsReload;
 
-@property (nonatomic, strong) NSDictionary* onLoadEvent;
+@property(nonatomic, strong) NSDictionary* onLoadEvent;
 
 @end
 
@@ -23,35 +23,35 @@
     return self;
 }
 
-- (void)setResizeMode:(RCTResizeMode)resizeMode {
+- (void) setResizeMode: (RCTResizeMode)resizeMode {
     if (_resizeMode != resizeMode) {
         _resizeMode = resizeMode;
-        self.contentMode = (UIViewContentMode)resizeMode;
+        self.contentMode = (UIViewContentMode) resizeMode;
     }
 }
 
-- (void)setOnFastImageLoadEnd:(RCTDirectEventBlock)onFastImageLoadEnd {
+- (void) setOnFastImageLoadEnd: (RCTDirectEventBlock)onFastImageLoadEnd {
     _onFastImageLoadEnd = onFastImageLoadEnd;
     if (self.hasCompleted) {
         _onFastImageLoadEnd(@{});
     }
 }
 
-- (void)setOnFastImageLoad:(RCTDirectEventBlock)onFastImageLoad {
+- (void) setOnFastImageLoad: (RCTDirectEventBlock)onFastImageLoad {
     _onFastImageLoad = onFastImageLoad;
     if (self.hasCompleted) {
         _onFastImageLoad(self.onLoadEvent);
     }
 }
 
-- (void)setOnFastImageError:(RCTDirectEventBlock)onFastImageError {
+- (void) setOnFastImageError: (RCTDirectEventBlock)onFastImageError {
     _onFastImageError = onFastImageError;
     if (self.hasErrored) {
         _onFastImageError(@{});
     }
 }
 
-- (void)setOnFastImageLoadStart:(RCTDirectEventBlock)onFastImageLoadStart {
+- (void) setOnFastImageLoadStart: (RCTDirectEventBlock)onFastImageLoadStart {
     if (_source && !self.hasSentOnLoadStart) {
         _onFastImageLoadStart = onFastImageLoadStart;
         onFastImageLoadStart(@{});
@@ -62,100 +62,106 @@
     }
 }
 
-- (void)setImageColor:(UIColor *)imageColor {
+- (void) setImageColor: (UIColor*)imageColor {
     if (imageColor != nil) {
         _imageColor = imageColor;
-        super.image = [self makeImage:super.image withTint:self.imageColor];
+        if (super.image) {
+            super.image = [self makeImage: super.image withTint: self.imageColor];
+        }
     }
 }
 
-- (UIImage*)makeImage:(UIImage *)image withTint:(UIColor *)color {
-    UIImage *newImage = [image imageWithRenderingMode:UIImageRenderingModeAlwaysTemplate];
+- (UIImage*) makeImage: (UIImage*)image withTint: (UIColor*)color {
+    UIImage* newImage = [image imageWithRenderingMode: UIImageRenderingModeAlwaysTemplate];
     UIGraphicsBeginImageContextWithOptions(image.size, NO, newImage.scale);
     [color set];
-    [newImage drawInRect:CGRectMake(0, 0, image.size.width, newImage.size.height)];
+    [newImage drawInRect: CGRectMake(0, 0, image.size.width, newImage.size.height)];
     newImage = UIGraphicsGetImageFromCurrentImageContext();
     UIGraphicsEndImageContext();
     return newImage;
 }
 
-- (void)setImage:(UIImage *)image {
+- (void) setImage: (UIImage*)image {
     if (self.imageColor != nil) {
-        super.image = [self makeImage:image withTint:self.imageColor];
+        super.image = [self makeImage: image withTint: self.imageColor];
     } else {
         super.image = image;
     }
 }
 
-- (void)sendOnLoad:(UIImage *)image {
+- (void) sendOnLoad: (UIImage*)image {
     self.onLoadEvent = @{
-                         @"width":[NSNumber numberWithDouble:image.size.width],
-                         @"height":[NSNumber numberWithDouble:image.size.height]
-                         };
+            @"width": [NSNumber numberWithDouble: image.size.width],
+            @"height": [NSNumber numberWithDouble: image.size.height]
+    };
     if (self.onFastImageLoad) {
         self.onFastImageLoad(self.onLoadEvent);
     }
 }
 
-- (void)setSource:(FFFastImageSource *)source {
+- (void) setSource: (FFFastImageSource*)source {
     if (_source != source) {
         _source = source;
         _needsReload = YES;
     }
 }
 
-- (void)didSetProps:(NSArray<NSString *> *)changedProps
-{
+- (void) setDefaultSource: (UIImage*)defaultSource {
+    if (_defaultSource != defaultSource) {
+        _defaultSource = defaultSource;
+        _needsReload = YES;
+    }
+}
+
+- (void) didSetProps: (NSArray<NSString*>*)changedProps {
     if (_needsReload) {
         [self reloadImage];
     }
 }
 
-- (void)reloadImage
-{
+- (void) reloadImage {
     _needsReload = NO;
 
     if (_source) {
-
         // Load base64 images.
         NSString* url = [_source.url absoluteString];
-        if (url && [url hasPrefix:@"data:image"]) {
+        if (url && [url hasPrefix: @"data:image"]) {
             if (self.onFastImageLoadStart) {
                 self.onFastImageLoadStart(@{});
                 self.hasSentOnLoadStart = YES;
-            } {
+            } else {
                 self.hasSentOnLoadStart = NO;
             }
             // Use SDWebImage API to support external format like WebP images
-            UIImage *image = [UIImage sd_imageWithData:[NSData dataWithContentsOfURL:_source.url]];
-            [self setImage:image];
+            UIImage* image = [UIImage sd_imageWithData: [NSData dataWithContentsOfURL: _source.url]];
+            [self setImage: image];
             if (self.onFastImageProgress) {
                 self.onFastImageProgress(@{
-                                           @"loaded": @(1),
-                                           @"total": @(1)
-                                           });
+                        @"loaded": @(1),
+                        @"total": @(1)
+                });
             }
             self.hasCompleted = YES;
-            [self sendOnLoad:image];
-            
+            [self sendOnLoad: image];
+
             if (self.onFastImageLoadEnd) {
                 self.onFastImageLoadEnd(@{});
             }
             return;
         }
-        
+
         // Set headers.
-        NSDictionary *headers = _source.headers;
-        SDWebImageDownloaderRequestModifier *requestModifier = [SDWebImageDownloaderRequestModifier requestModifierWithBlock:^NSURLRequest * _Nullable(NSURLRequest * _Nonnull request) {
-            NSMutableURLRequest *mutableRequest = [request mutableCopy];
-            for (NSString *header in headers) {
-                NSString *value = headers[header];
-                [mutableRequest setValue:value forHTTPHeaderField:header];
+        NSDictionary* headers = _source.headers;
+        SDWebImageDownloaderRequestModifier* requestModifier = [SDWebImageDownloaderRequestModifier requestModifierWithBlock: ^NSURLRequest* _Nullable (NSURLRequest* _Nonnull request) {
+            NSMutableURLRequest* mutableRequest = [request mutableCopy];
+            for (NSString* header in headers) {
+                NSString* value = headers[header];
+                [mutableRequest setValue: value forHTTPHeaderField: header];
             }
             return [mutableRequest copy];
         }];
-        SDWebImageContext *context = @{SDWebImageContextDownloadRequestModifier : requestModifier};
-        
+        SDWebImageContext* context = @{SDWebImageContextDownloadRequestModifier: requestModifier};
+
         // Set priority.
         SDWebImageOptions options = SDWebImageRetryFailed | SDWebImageHandleCookies;
         switch (_source.priority) {
@@ -169,7 +175,7 @@
                 options |= SDWebImageHighPriority;
                 break;
         }
-        
+
         switch (_source.cacheControl) {
             case FFFCacheControlWeb:
                 options |= SDWebImageRefreshCached;
@@ -180,56 +186,58 @@
             case FFFCacheControlImmutable:
                 break;
         }
-        
+
         if (self.onFastImageLoadStart) {
             self.onFastImageLoadStart(@{});
             self.hasSentOnLoadStart = YES;
-        } {
+        } else {
             self.hasSentOnLoadStart = NO;
         }
         self.hasCompleted = NO;
         self.hasErrored = NO;
-        
-        [self downloadImage:_source options:options context:context];
+
+        [self downloadImage: _source options: options context: context];
+    } else if (_defaultSource) {
+        [self setImage: _defaultSource];
     }
 }
 
-- (void)downloadImage:(FFFastImageSource *) source options:(SDWebImageOptions) options context:(SDWebImageContext *)context {
+- (void) downloadImage: (FFFastImageSource*)source options: (SDWebImageOptions)options context: (SDWebImageContext*)context {
     __weak typeof(self) weakSelf = self; // Always use a weak reference to self in blocks
-    [self sd_setImageWithURL:_source.url
-            placeholderImage:nil
-                     options:options
-                     context:context
-                    progress:^(NSInteger receivedSize, NSInteger expectedSize, NSURL * _Nullable targetURL) {
+    [self sd_setImageWithURL: _source.url
+            placeholderImage: _defaultSource
+                     options: options
+                     context: context
+                    progress: ^(NSInteger receivedSize, NSInteger expectedSize, NSURL* _Nullable targetURL) {
                         if (weakSelf.onFastImageProgress) {
                             weakSelf.onFastImageProgress(@{
-                                                           @"loaded": @(receivedSize),
-                                                           @"total": @(expectedSize)
-                                                           });
-                        }
-                    } completed:^(UIImage * _Nullable image,
-                                  NSError * _Nullable error,
-                                  SDImageCacheType cacheType,
-                                  NSURL * _Nullable imageURL) {
-                        if (error) {
-                            weakSelf.hasErrored = YES;
-                                if (weakSelf.onFastImageError) {
-                                    weakSelf.onFastImageError(@{});
-                                }
-                                if (weakSelf.onFastImageLoadEnd) {
-                                    weakSelf.onFastImageLoadEnd(@{});
-                                }
-                        } else {
-                            weakSelf.hasCompleted = YES;
-                            [weakSelf sendOnLoad:image];
-                            if (weakSelf.onFastImageLoadEnd) {
-                                weakSelf.onFastImageLoadEnd(@{});
-                            }
+                                    @"loaded": @(receivedSize),
+                                    @"total": @(expectedSize)
+                            });
                         }
-                    }];
+                    } completed: ^(UIImage* _Nullable image,
+                    NSError* _Nullable error,
+                    SDImageCacheType cacheType,
+                    NSURL* _Nullable imageURL) {
+                if (error) {
+                    weakSelf.hasErrored = YES;
+                    if (weakSelf.onFastImageError) {
+                        weakSelf.onFastImageError(@{});
+                    }
+                    if (weakSelf.onFastImageLoadEnd) {
+                        weakSelf.onFastImageLoadEnd(@{});
+                    }
+                } else {
+                    weakSelf.hasCompleted = YES;
+                    [weakSelf sendOnLoad: image];
+                    if (weakSelf.onFastImageLoadEnd) {
+                        weakSelf.onFastImageLoadEnd(@{});
+                    }
+                }
+            }];
 }
 
-- (void)dealloc {
+- (void) dealloc {
     [self sd_cancelCurrentImageLoad];
 }
 

package/ios/FastImage/FFFastImageViewManager.m

@@ -13,6 +13,7 @@ RCT_EXPORT_MODULE(FastImageView)
 }
 
 RCT_EXPORT_VIEW_PROPERTY(source, FFFastImageSource)
+RCT_EXPORT_VIEW_PROPERTY(defaultSource, UIImage)
 RCT_EXPORT_VIEW_PROPERTY(resizeMode, RCTResizeMode)
 RCT_EXPORT_VIEW_PROPERTY(onFastImageLoadStart, RCTDirectEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onFastImageProgress, RCTDirectEventBlock)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "react-native-fast-image",
-    "version": "8.5.12",
+    "version": "8.6.0",
     "description": "🚩 FastImage, performant React Native image component.",
     "keywords": [
         "cache",
@@ -64,7 +64,7 @@
         "@babel/runtime": "^7.14.6",
         "@types/jest": "^26.0.24",
         "@types/react": "^17.0.14",
-        "@types/react-native": "^0.64.12",
+        "@types/react-native": "^0.69.5",
         "@types/react-test-renderer": "^17.0.1",
         "dv-scripts": "^1.6.0",
         "eslint-config-dv-scripts": "^1.1.1",