パッケージの詳細

@giphy/react-native-sdk

Giphy39.6kApache-2.04.1.0

Giphy React Native SDK

react-native, ios, android, giphy

readme

GIPHY SDK for React Native

The fastest and easiest way to bring the full GIPHY experience directly to your app is with the GIPHY SDK. Built with developers and product designers in mind, GIPHY SDK is a top-to-bottom solution for all things GIF in your app.

With support for the React Native developer ecosystem, this project enables you to easily integrate our battle-tested native iOS and Android SDKs, which handle everything from interfacing with the GIPHY API, fetching and caching assets, and displaying GIFs and Stickers on screen in customizable UI templates.

With billions of requests a day, it’s safe to say GIPHY knows GIFs. We're excited to share our best-in-class tools with you so your users can have the best GIF experience possible, with all the same features they're already enjoying on Facebook, Slack, Instagram, and more – with just a few lines of code.

Getting Started

API Reference

Guides

更新履歴

4.1.0 (2025-06-24)

Native SDKs

Features

  • [android] Add Edge-To-Edge support (b8c1191)

Build System

  • [deps-dev] Bump @babel/runtime from 7.23.2 to 7.26.10 in /example (180cdaf)
  • [deps] Bump @babel/helpers from 7.22.6 to 7.27.1 in /example (b0d86db)

4.0.2 (2025-05-21)

Native SDKs

Documentation

  • [iOS] Update requirements (16828fb)

Build System

  • [deps] Bump iOS SDK version from 2.2.14 to 2.2.16 (a426323)

4.0.1 (2025-02-21)

Native SDKs

Bug Fixes

  • [android): RN 0.76+(new arch] Unsupported top level event type (14a9a3c)

Build System

  • [deps] Bump cross-spawn from 7.0.3 to 7.0.6 in /example (79f142b)
  • [deps] Bump iOS SDK version from 2.2.13 to 2.2.14 (e3c84e3)

4.0.0 (2025-02-03)

Native SDKs

Documentation

  • Add troubleshooting page for "GIFs Are Not Playing on Android" (7fe466e)

Build System

  • [deps] Bump rexml from 3.3.6 to 3.3.9 in /example (e824735)
  • Feat!: drop support for React Native <0.73.0 (ec9b8ba)

BREAKING CHANGES

  • Support for React Native versions before 0.73.0 has been removed.

build(deps): bump Android SDK version from 2.3.15-fresco-v2.5.0 to 2.3.16

3.3.1 (2024-10-18)

Native SDKs

Build System

  • [deps] Bump fast-xml-parser from 4.2.5 to 4.4.1 in /example (47aec8a)
  • [deps] Bump iOS SDK version from 2.2.10 to 2.2.13 (ddfac07)
  • [deps] Bump micromatch from 4.0.5 to 4.0.8 (2379e70)
  • [deps] Bump micromatch from 4.0.5 to 4.0.8 in /example (0c8f17b)
  • [deps] Bump rexml from 3.2.8 to 3.3.6 in /example (da06fc5)
  • [deps] Bump serve-static from 1.15.0 to 1.16.2 (1736c96)
  • [deps] Bump serve-static from 1.15.0 to 1.16.2 in /example (e223fba)

3.3.0 (2024-08-12)

Native SDKs

Features

  • [localization] Add localizations support (#183) (973abbe)

Documentation

  • How to mock the Giphy dependency in Jest (#184) (5426f23)

Build System

  • [deps] Bump Android SDK version from 2.3.14-fresco-v2.5.0 to 2.3.15-fresco-v2.5.0 (e502281)
  • [deps] Bump braces from 3.0.2 to 3.0.3 (fcd5ce9)
  • [deps] Bump braces from 3.0.2 to 3.0.3 in /example (bbe36c7)
  • [deps] Bump fast-xml-parser from 4.2.5 to 4.4.1 (d6ecd35)
  • [deps] Bump iOS SDK version from 2.2.9 to 2.2.10 (e357a45)
  • [deps] Bump ws from 6.2.2 to 6.2.3 in /example (be1b73d)

3.2.6 (2024-05-22)

Native SDKs

Build System

  • [deps] Bump Android SDK version from 2.3.13-fresco-v2.5.0 to 2.3.14-fresco-v2.5.0 (b8c219f)
  • [deps] Bump rexml from 3.2.5 to 3.2.8 in /example (0bcbb7b)

3.2.5 (2024-04-26)

Native SDKs

Build System

  • [deps] Bump iOS SDK version from 2.2.7 to 2.2.9 (96414f9)

3.2.4 (2024-04-08)

Native SDKs

Bug Fixes

  • The GridView crashes when scrolling and closing the screen (#172) (0288130)

3.2.3 (2024-02-21)

Native SDKs

Bug Fixes

  • [iOS] GiphyDialog does not work with formSheet modal when using native-stack (e4e7974)

Build System

  • [deps] Bump ip from 1.1.8 to 1.1.9 (dbc1c03)
  • [deps] Bump ip from 1.1.8 to 1.1.9 in /example (9bbb472)

3.2.2 (2024-01-05)

Native SDKs

Bug Fixes

  • [iOS] Issues with ios in rn versions starting from 0.73.0 and onwards (#161) (41df28f)

3.2.1 (2023-10-31)

Native SDKs

  • Giphy Android SDK v
  • Giphy iOS SDK v2.2.7

Documentation

  • [expo] Update integration guide (0cd489f)

Build System

  • [deps] Bump semver from 5.7.1 to 5.7.2 in /example (1110c4d)
  • [deps] Change Android SDK version from 2.3.12 to 2.3.12-fresco-v2.5.0 (55c5c17)
  • [deps] Change Android SDK version from 2.3.12-fresco-v2.5.0 to 2.3.13-fresco-v2.5.0 (d48400b)

3.2.0 (2023-10-23)

Native SDKs

Features

  • [GiphyGridView] Add disableEmojiVariations property (151782d)

Build System

  • [deps] Bump @babel/traverse from 7.22.8 to 7.23.2 (31231d5)
  • [deps] Bump @babel/traverse from 7.22.8 to 7.23.2 in /example (63f723b)
  • [deps] Bump Android SDK version from 2.3.9 to 2.3.12 (5c541ad)
  • [deps] Bump iOS SDK version from 2.2.6 to 2.2.7 (3e07646)
  • [deps] Bump react-devtools-core from 4.27.8 to 4.28.4 (26c9848)
  • [deps] Bump react-devtools-core from 4.27.8 to 4.28.4 in /example (a213401)
  • [deps] Bump type-fest version from 3.13.0 to 4.5.0 (c2508a6)

3.0.1 (2023-10-19)

Native SDKs

Documentation

  • Add Expo integration guide (f21545e)

Build System

  • [deps] Bump activesupport from 7.0.6 to 7.0.7.2 in /example (6fd834c)

3.0.0 (2023-08-16)

Native SDKs

Features

  • Add support for new React Native architecture (5158df3)

2.4.2 (2023-07-18)

Native SDKs

Bug Fixes

  • [android] GiphyGridView doesn't refresh its content in certain scenarios (#126) (6f5ca67)

Build System

  • [deps] Bump Android SDK version from 2.3.6 to 2.3.6-hotfix-grid (#126) (6f5ca67)
  • [deps] Bump semver from 5.7.1 to 5.7.2 (a2f047b)
  • [deps] Bump semver from 5.7.1 to 5.7.2 in /example (dfc6e42)

2.4.1 (2023-06-13)

Native SDKs

Build System

  • [deps] Bump Android SDK version from 2.3.5 to 2.3.6 (b61625e)
  • [deps] Bump iOS SDK version from 2.2.5 to 2.2.6 (35bce1d)
  • [deps] Bump @sideway/formula from 3.0.0 to 3.0.1 in /example (bb41d8b)
  • [deps] Bump ansi-regex from 3.0.0 to 3.0.1 (a3c430d)
  • [deps] Bump async from 2.6.3 to 2.6.4 (cc740a9)
  • [deps] Bump decode-uri-component from 0.2.0 to 0.2.2 (98b613c)
  • [deps] Bump decode-uri-component from 0.2.0 to 0.2.2 in /example (8be76e4)
  • [deps] Bump http-cache-semantics from 4.1.0 to 4.1.1 (2d7c007)
  • [deps] Bump json5 from 2.2.1 to 2.2.3 (df2825f)
  • [deps] Bump minimatch from 3.0.4 to 3.1.2 (057683d)
  • [deps] Bump shell-quote from 1.6.1 to 1.8.1 (95d938b)
  • [deps] Bump simple-plist from 1.3.0 to 1.3.1 (b0a7731)
  • [deps] Bump vm2 from 3.9.10 to 3.9.19 (cda53db)

2.4.0 (2023-05-24)

Native SDKs

Features

  • [GiphyDialog] Add theme support (04cfdfe)
  • [GiphyGridView] Add theme support (70a94e9)

Documentation

  • Add the GIPHY Theme section (33f4808)

Build System

  • [deps] Bump Android SDK version from 2.3.4 to 2.3.5 (93864e6)
  • [deps] Bump iOS SDK version from 2.2.4 to 2.2.5 (18679a5)
  • [deps] Bump type-fest, @giphy/js-types, and other dev deps (6007de4)

2.3.0 (2023-05-08)

Native SDKs

Features

  • [GiphyDialog] Add enableDynamicText property (281c715)

Documentation

  • Add GIPHY Animated Text page (e8f8c54)

2.2.1 (2023-04-27)

Native SDKs

Build System

  • [deps] Bump Android SDK version from 2.3.1 to 2.3.4 (491a526)

2.2.0 (2023-04-25)

Native SDKs

Features

  • [iOS:GiphyDialog] Add selectedContentType property (#99) (e21a85a)

Build System

  • [deps] Bump iOS SDK version from 2.2.2 to 2.2.4 (31e6a52)

2.1.3 (2023-03-02)

Native SDKs

Bug Fixes

  • [Android] App crashes when selecting a Gif (#90) (8a18094)

2.1.2 (2023-02-08)

Native SDKs

Bug Fixes

  • [android] Project-wide requests headers rewritten by GIPHY (#92) (b0ce09c)

Build System

  • [deps] Bump Android SDK version from 2.3.0 to 2.3.1 (03e2a89)

2.1.1 (2023-01-11)

Native SDKs

Build System

  • [deps] Bump iOS SDK version from 2.2.1 to 2.2.2 (28b45e7)

2.1.0 (2022-12-01)

Native SDKs

Build System

  • [deps] Bump Android SDK version from 2.2.0 to 2.3.0 (682bfa5)
  • [deps] Bump iOS SDK version from 2.1.22 to 2.2.1 (461e857)

Emoji Drawer

This release improves the experience for the GIPHY emoji tab by enabling users to browse and select variations for a given emoji, such as alternative skin tones. This is a feature standardized by a number of popular platforms and is now possible in the GIPHY SDK.

If you already have the emoji content type included in your integration, no additional code is necessary on your end to adopt this new feature.

2.0.0 (2022-10-31)

Native SDKs

Features

  • Update ExoPlayer configuration (907ea53)
  • [GiphyVideoView] Remove the playing property (032a67e)

Documentation

  • Add a v2 migration guide (e68fd20)
  • Update GIPHY Clips integration guide (21f57e8)

Build System

  • [deps] Bump npm packages (f4dd163)

BREAKING CHANGES

  • The playing property has been removed from the GiphyVideoView component. Please replace it with the autoPlay property if you use it.
  • In v2, GIPHY Clips are disabled by default on the Android platform. If you use clips on Android, follow this guide to set them up.

1.11.1 (2022-10-03)

Native SDKs

Bug Fixes

  • TypeScript definitions are placed in the wrong folder (#80) (4bea260)

1.11.0 (2022-09-28)

Native SDKs

Build System

  • [deps] Bump Gradle to 7.3.3 (2ffb2e5)
  • [deps] Bump Kotlin to 1.6.0 (81b11ed)

1.10.0 (2022-09-27)

Native SDKs

Documentation

  • Add the ExoPlayer troubleshooting page (00dfa75)
  • Update contribution guide (f3ef81b)

Build System

  • Update dependencies (3813062)
  • [deps] Bump Android SDK version from 2.1.18 to 2.2.0 (4934f9f)

Continuous Integration

  • Setup detox for Android platform (d793b18)
  • Setup detox for iOS platform (a2465ea)

1.10.0-beta.0 (2022-09-22)

Native SDKs

Documentation

  • Add the ExoPlayer troubleshooting page (00dfa75)
  • Update contribution guide (f3ef81b)

Build System

  • Update dependencies (3813062)
  • [deps] Bump Android SDK version from 2.1.18 to 2.2.0 (4934f9f)

Continuous Integration

  • Setup detox for Android platform (d793b18)
  • Setup detox for iOS platform (a2465ea)

1.9.1 (2022-08-31)

Native SDKs

Bug Fixes

  • [Android:GiphyDialog] GIPHY rating does not work when using GiphyDialog.configure to specify it (#74) (cf2b55e)

1.9.0 (2022-06-27)

Native SDKs

Features

  • [GiphyVideoManager] Add the resume method to continue paused playback (c2d6d1b)

Bug Fixes

  • [GiphyVideoView] Sound suddenly starts playing out of nowhere (#69) (a7c2a03)

1.8.0 (2022-06-21)

Native SDKs

Features

  • [GPHMediaView] Add the resizeMode property. This property determines how to resize the image when the frame doesn't match the raw image dimensions. (6ff254a)

1.8.0-rc.1 (2022-06-20)

Native SDKs

Features

  • [GPHMediaView] Add the resizeMode property (6ff254a)

1.8.0-rc.0 (2022-06-17)

Native SDKs

Features

  • [iOS:GPHMediaView] Scale the content to fill the view bounds and maintain the aspect ratio (8cf112c)

1.7.2 (2022-06-15)

Native SDKs

Build System

  • [deps] Bump @giphy/js-types to 4.2.1 and type-fest to 2.13.1 (db8d8a8)
  • [deps] Bump Android SDK version from 2.1.17 to 2.1.18 (d538105)
  • [deps] Bump iOS SDK version from 2.1.21 to 2.1.22 (63fed92)

1.7.1 (2022-04-26)

Native SDKs

Documentation

  • Update the requirements section (b615d31)

Build System

  • [android] Update gradle and target SDK (17dc5b6)
  • [deps] Bump Android SDK version from 2.1.16 to 2.1.17 (efe7d11)
  • [deps] Bump iOS SDK version from 2.1.20 to 2.1.21 (e362e28)

Continuous Integration

1.7.0 (2022-03-09)

Native SDKs

Performance Improvements

  • [ios:giphy-video-view] Reuse a single video player across multiple clips (8c4ea74)

Build System

  • [deps] Bump iOS SDK version from 2.1.17 to 2.1.20 (73807b0)

1.6.0 (2022-02-15)

Native SDKs

Features

  • [GiphyContent] Add the prop to specify content rating for the search results (#58) (fe22af7)

1.5.0 (2022-02-01)

Native SDKs

Features

  • Deep Press Previews. This new feature enables users to "deep press" on a piece of content in the grid and view a context menu, including various options such as select, more by @user-name, and remove from recents, which is only shown in the case the grid is populated with previously selected content.

    While this feature applies to all content types in the GIPHY SDK, we were motivated to develop it specifically to enhance the experience for Clips (GIFs With Sound!), so that users may much more seamlessly experience video content without having to leave the context of the grid.

    Whereas previously the only method of hearing a Clip was to tap on its silent preview in the grid, taking the user to the detail screen, users may now "deep press" on the preview to see and hear it in inline.

Build System

  • [deps] Bump Android SDK version from 2.1.14 to 2.1.16 (2549c6f)
  • [deps] Bump iOS sdk version from 2.1.16 to 2.1.17 (5335063)

1.4.1 (2022-01-18)

Native SDKs

Bug Fixes

  • [Android:GiphyDialog] Fix an issue where calling GiphyDialog.show() on an Android device could cause an error (#52) (860387a)

1.4.0 (2022-01-12)

Native SDKs

Features

  • [Android:GiphyMediaView] Add the showCheckeredBackground property (#50) (e50103f)
  • [Android:GiphySDK] Add the videoCacheMaxBytes property (#49) (8406613)

Build System

1.3.0 (2021-12-08)

Native SDKs

Bug Fixes

  • [ios] Fix the issue with reference to self in async blocks (ca9d444)

Features

  • [GiphyMediaView] Add an API to control play/pause states (c3ec0e2)

1.2.0 (2021-12-01)

Native SDKs

Bug Fixes

  • [Android] Fix NativeEventEmitter warnings in RN 0.65 (#43) (1a65090)
  • [Android:GiphyGridView] Fix issue with rendering the recent GIFs (#41) (11fa2ce)

Features

  • Captions! A Closed Captions control is now provided for the .Clips content type on both the detail "confirmation" screen as well as the GiphyVideoView

Build System

1.1.1 (2021-10-06)

Native SDKs

Bug Fixes

  • [Android:GiphyGridView] Fix crash on didLongPressCell (#33) @M1ST4KE

1.1.0 (2021-09-09)

Native SDKs

Bug Fixes

  • Bumps scripts don't update lockfile (bd4cc43)
  • Issues where state saves references only to the props for the last component (14b9236)
  • [GiphyVideoView] Typo (edc62ae)

Features

  • [GiphyVideoManager] This is a new module that allows to mute or pause all clips. For example, you can pause all clips when a user opens a modal.
  • [GiphyGridView] Add showCheckeredBackground prop
  • [GiphyVideoView] Add callback support for onPlaybackStateChanged, onMute, onUnmute, and onError events.
  • [GiphyVideoView] Add autoPlay prop as a replacement for playing prop to avoid misuse of the component.
  • [GiphyVideoView] Mark playing prop as deprecated.

Build System

1.0.3 (2021-08-26)

Native SDKs

Bug Fixes

  • [Android:GiphyVideoViewManager] Fix the issue with viewing multiple clips
  • [Android:Utils] Fix app crashes due to absent rendition in media

Build System

1.0.2 (2021-08-19)

Native SDKs

Bug Fixes

  • [GiphyDialog] Fix launch error when rootViewController is nil (#19) (81ff417)

1.0.1 (2021-08-09)

Native SDKs

Features

  • [GiphySDK] Add metadata to the configuration method
  • [LICENSE] Update to Apache-2.0 license

1.0.0 (2021-07-21)

Native SDKs

Features

  • Clips (GIFs with Sound!) is a brand new content type available in the SDK
  • [GiphyDialog] Add clipsPreviewRenditionType prop
  • [GiphyGridView] Add clipsPreviewRenditionType and renditionType props

Documentation

  • [Docs] Add section for GiphyVideoView

BREAKING CHANGES

  • [GiphyDialog] Remove useBlurredBackground prop