65 lines
1.7 KiB
JavaScript
65 lines
1.7 KiB
JavaScript
/**
|
|
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*
|
|
* @flow strict-local
|
|
* @format
|
|
*/
|
|
|
|
import type {ImageURISource} from './ImageSource';
|
|
|
|
import Platform from '../Utilities/Platform';
|
|
|
|
type NativeImageSourceSpec = $ReadOnly<{|
|
|
android?: string,
|
|
ios?: string,
|
|
default?: string,
|
|
|
|
// For more details on width and height, see
|
|
// https://reactnative.dev/docs/images#why-not-automatically-size-everything
|
|
height: number,
|
|
width: number,
|
|
|}>;
|
|
|
|
/**
|
|
* In hybrid apps, use `nativeImageSource` to access images that are already
|
|
* available on the native side, for example in Xcode Asset Catalogs or
|
|
* Android's drawable folder.
|
|
*
|
|
* However, keep in mind that React Native Packager does not guarantee that the
|
|
* image exists. If the image is missing you'll get an empty box. When adding
|
|
* new images your app needs to be recompiled.
|
|
*
|
|
* Prefer Static Image Resources system which provides more guarantees,
|
|
* automates measurements and allows adding new images without rebuilding the
|
|
* native app. For more details visit:
|
|
*
|
|
* https://reactnative.dev/docs/images
|
|
*
|
|
*/
|
|
function nativeImageSource(spec: NativeImageSourceSpec): ImageURISource {
|
|
let uri = Platform.select({
|
|
android: spec.android,
|
|
default: spec.default,
|
|
ios: spec.ios,
|
|
});
|
|
if (uri == null) {
|
|
console.warn(
|
|
'nativeImageSource(...): No image name supplied for `%s`:\n%s',
|
|
Platform.OS,
|
|
JSON.stringify(spec, null, 2),
|
|
);
|
|
uri = '';
|
|
}
|
|
return {
|
|
deprecated: true,
|
|
height: spec.height,
|
|
uri,
|
|
width: spec.width,
|
|
};
|
|
}
|
|
|
|
module.exports = nativeImageSource;
|