@onekeyfe/react-native-image 3.0.98

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 @onekeyfe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/OneKeyImage.podspec

@@ -0,0 +1,32 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "OneKeyImage"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/OneKeyHQ/app-modules.git", :tag => "#{s.version}" }
+
+  s.source_files = ["ios/**/*.{swift,m,mm}", "cpp/**/*.{hpp,cpp}"]
+  s.exclude_files = "ios/tests/**/*"
+
+  s.dependency "React-jsi"
+  s.dependency "React-callinvoker"
+  s.dependency "SDWebImage", "~> 5.21.7"
+  s.dependency "SDWebImageSVGCoder", "~> 1.7.0"
+  s.dependency "SDWebImageWebPCoder", "~> 0.14.6"
+  s.dependency "Skeleton", package["version"]
+
+  load "nitrogen/generated/ios/OneKeyImage+autolinking.rb"
+  add_nitrogen_files(s)
+  install_modules_dependencies(s)
+
+  s.test_spec "Tests" do |test_spec|
+    test_spec.source_files = "ios/tests/**/*.swift"
+  end
+end

package/README.md

@@ -0,0 +1,88 @@
+# @onekeyfe/react-native-image
+
+Nitro HybridView backed by SDWebImage on iOS and Glide on Android. It provides
+native loading placeholders, opt-in shared-renderer skeleton, fallback states,
+cache controls,
+and conservative OneKey TOS URL resizing without depending on Expo Image.
+
+```tsx
+<OneKeyImage
+  source={{ uri: 'https://example.com/avatar.png' }}
+  variant={OneKeyImageVariant.AVATAR}
+  style={{ width: 48, height: 48 }}
+/>
+```
+
+React placeholders and fallbacks are optional overlays. The default path draws
+all states in the native image view and never nests SkeletonView. The public
+state semantics match the native image libraries:
+
+- `placeholder`: shown while a non-null source is loading.
+- `fallback`: shown when `source` is null, cannot be resolved, or fails to load.
+
+`onError` is only emitted for an actual request failure; a null source displays
+the same fallback UI without emitting an error event.
+
+The React event payloads follow the Expo Image envelope used by OneKey:
+
+```ts
+onLoad={({ source: { url, width, height }, cacheType }) => {}}
+onError={({ error }) => {}}
+```
+
+`cacheType` is `OneKeyImageCacheType.NONE`, `.MEMORY`, or `.DISK`.
+`placeholder` remains visible through decode and is removed by `onDisplay`,
+when the decoded image has actually reached the screen. Overlay containers also
+clip their contents so image, placeholder, and fallback share the same rounded
+corners.
+
+The default loading strategy is a lightweight static native placeholder. Native
+skeleton loading is opt-in and replaces the static loading appearance instead
+of appearing as a second stage:
+
+```tsx
+<OneKeyImage
+  source={{ uri }}
+  loadingStrategy={OneKeyImageLoadingStrategy.SKELETON}
+  fallback={<UnavailableImagePlaceholder />}
+/>
+```
+
+Passing a React `placeholder` disables the native loading strategy for that
+instance so only one loading surface is visible.
+
+Animated images intentionally default to `autoplay={false}` on Android to keep
+large lists conservative, and `autoplay={true}` on other native platforms. Pass
+`autoplay` explicitly whenever a screen needs the same behavior on both
+platforms.
+
+`recyclingKey` is available for recycled list cells. Changing it clears stale
+content before the next source is displayed.
+
+Cache clearing methods resolve only after their requested native cache work has
+completed, including `OneKeyImageCache.clearMemory()`.
+
+Pass the rendered logical dimensions and device pixel ratio when preloading so
+TOS URL selection and decode cache identity match the later render. `preload`
+resolves to `true` only when all requested sources complete successfully:
+
+```ts
+const loaded = await OneKeyImageCache.preload([
+  {
+    uri,
+    resizeWidth: 48,
+    resizeHeight: 64,
+    pixelRatio: 3,
+    overscan: 1.1,
+  },
+]);
+```
+
+For a CocoaPods static-library integration, declare SDWebImage as a modular
+header in the application Podfile:
+
+```ruby
+pod 'SDWebImage', '5.21.7', :modular_headers => true
+pod 'SDWebImageWebPCoder', '0.14.6', :modular_headers => true
+pod 'SDWebImageSVGCoder', '1.7.0', :modular_headers => true
+```

package/android/CMakeLists.txt

@@ -0,0 +1,12 @@
+project(onekeyimage)
+cmake_minimum_required(VERSION 3.9.0)
+
+set(PACKAGE_NAME onekeyimage)
+set(CMAKE_VERBOSE_MAKEFILE ON)
+set(CMAKE_CXX_STANDARD 20)
+
+add_library(${PACKAGE_NAME} SHARED src/main/cpp/cpp-adapter.cpp)
+include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/onekeyimage+autolinking.cmake)
+include_directories("src/main/cpp" "../cpp")
+find_library(LOG_LIB log)
+target_link_libraries(${PACKAGE_NAME} ${LOG_LIB} android)

package/android/build.gradle

@@ -0,0 +1,85 @@
+buildscript {
+  ext.getExtOrDefault = { name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['OneKeyImage_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+def reactNativeArchitectures() {
+  def value = rootProject.getProperties().get("reactNativeArchitectures")
+  return value ? value.split(",") : ["armeabi-v7a", "x86", "x86_64", "arm64-v8a"]
+}
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+apply from: '../nitrogen/generated/android/onekeyimage+autolinking.gradle'
+apply plugin: "com.facebook.react"
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["OneKeyImage_" + name]).toInteger()
+}
+
+android {
+  namespace "com.margelo.nitro.onekeyimage"
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+    consumerProguardFiles "consumer-rules.pro"
+    externalNativeBuild {
+      cmake {
+        cppFlags "-frtti -fexceptions -Wall -fstack-protector-all"
+        arguments "-DANDROID_STL=c++_shared", "-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON"
+        abiFilters (*reactNativeArchitectures())
+      }
+    }
+  }
+
+  externalNativeBuild { cmake { path "CMakeLists.txt" } }
+  packagingOptions {
+    excludes = [
+      "META-INF", "META-INF/**", "**/libc++_shared.so", "**/libfbjni.so",
+      "**/libjsi.so", "**/libfolly_json.so", "**/libfolly_runtime.so",
+      "**/libglog.so", "**/libhermes.so", "**/libhermes_executor.so",
+      "**/libreactnative.so", "**/libreactnativejni.so"
+    ]
+  }
+  buildFeatures { buildConfig true; prefab true }
+  buildTypes { release { minifyEnabled false } }
+  lintOptions { disable "GradleCompatible" }
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+  sourceSets {
+    main { java.srcDirs += ["generated/java", "generated/jni"] }
+  }
+}
+
+repositories { mavenCentral(); google() }
+
+def kotlinVersion = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlinVersion"
+  def glideVersion = "5.0.5"
+  implementation "com.github.bumptech.glide:glide:$glideVersion"
+  implementation "com.github.bumptech.glide:avif-integration:$glideVersion"
+  implementation "com.github.bumptech.glide:okhttp3-integration:$glideVersion"
+  implementation "com.caverock:androidsvg-aar:1.4"
+  implementation "com.github.penfeizhou.android.animation:glide-plugin:3.0.5"
+  implementation project(":react-native-nitro-modules")
+  implementation project(":onekeyfe_react-native-skeleton")
+  testImplementation "junit:junit:4.13.2"
+}

package/android/consumer-rules.pro

@@ -0,0 +1,10 @@
+# Glide and optional image decoders are reached through the registry.
+-keep public class * extends com.bumptech.glide.module.LibraryGlideModule
+-keep public enum com.bumptech.glide.load.ImageHeaderParser$** {
+  **[] $VALUES;
+  public *;
+}
+-keep class com.bumptech.glide.load.data.ParcelFileDescriptorRewinder$InternalRewinder {
+  *** rewind();
+}
+-dontwarn com.bumptech.glide.load.resource.bitmap.VideoDecoder

package/android/gradle.properties

@@ -0,0 +1,5 @@
+OneKeyImage_kotlinVersion=2.1.20
+OneKeyImage_minSdkVersion=24
+OneKeyImage_targetSdkVersion=36
+OneKeyImage_compileSdkVersion=36
+OneKeyImage_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" />

package/android/src/main/cpp/cpp-adapter.cpp

@@ -0,0 +1,6 @@
+#include <jni.h>
+#include "onekeyimageOnLoad.hpp"
+
+JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+  return margelo::nitro::onekeyimage::initialize(vm);
+}