tyiu/EmojiKit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 4 Wiki Activity

Add iOS 18.4 and Unicode 16 support

Browse Source
This commit is contained in:
Terry Yiu
2025-03-03 20:58:36 -05:00
parent 05805f72d6
commit 47a4b1402d
8 changed files with 17 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
README.md
View File

@@ -40,13 +40,10 @@ let emojisByCategory: [EmojiCategory] = EmojiManager.getAvailableEmojis()
## EmojiSourceKit
> In most cases this part is not necessary if you just want to get the emojis in Swift. If you want to do some manual fetching or your app supports iOS versions below `iOS 15.0`, this chapter is for you.
> In most cases this part is not necessary if you just want to get the emojis in Swift. If you want to do some manual fetching, this chapter is for you.
The main idea behind this script is that there is no full list of supported emojis that can be easily used in Swift. This script fetches the full list of emojis from Unicode.org, parses them and returns a structured `emojis_vX.json` file where all emojis are assigned to their official unicode category. The `.json` files can be easily parsed afterwards for further usage in any product.
> **Note**
> Unicode released version 15.1 already, however these Emojis are not yet supported on iOS. `EmojiSourceKit` already contains the new Emojis, but they can't be used on iOS yet. We will release a new version once Apple integrated them.
### Installation
##### Manual
@@ -70,10 +67,11 @@ emojiSourceKit download <path> -v <version>
**Arguments:**
* `path`: Specify the directory where the `emoji_v<version>.json` file should be stored. Only provide the directory like `/Desktop` or `.` for the current directory, not the whole file path.
* `version (--version, -v)`: Currently only version `14` and `15` (latest) are supported.
* `version (--version, -v)`: Currently only version `13.1`, `14`, `15`, `15.1`, and `16` are supported.
#### Working with unsupported Versions
Currently only to Unicode releases are supported (Version 14 and 15). If you want to have access to emojis from older versions, you need to edit the source code manually.
Unicode versions 13.1, 14, 15, 15.1, and 16 are supported.
If you want to have access to emojis from older versions, you need to edit the source code manually.
1. Add a new enum case to the `EmojiManager.Version` enum. For example for Version 12, you would need to add `case v12 = 12`. Also, add a `versionIdentifier`. This should match the release number from Unicode.rog **exactly**. You can find all releases [here](https://unicode.org/Public/emoji/).
2. Modify the `getSupportedVersion` function to return your new enum case for the corresponding iOS version.
@@ -83,7 +81,7 @@ Currently only to Unicode releases are supported (Version 14 and 15). If you wan
## Troubleshooting
1. **Emojis are rendered as <`?`> in my app:**
If you're using the `EmojiKit` you're most likely running the App on a device with an iOS version below `iOS 15.0`. That is currently not supported. To still make it work, follow the instructions of running `EmojiSourceKit` with unsupported versions to get all emojis that are supported on your device's iOS version.
If you're using the `EmojiKit` you're most likely running the App on a device with an iOS version below `iOS 18.4`. That is currently not supported. To still make it work, follow the instructions of running `EmojiSourceKit` with unsupported versions to get all emojis that are supported on your device's iOS version.
2. **The `EmojiManager` does not return any emojis when using the `url` parameter:**