xander/main
1
0
Fork 0
mirror of https://github.com/googlefonts/noto-emoji.git synced 2025-06-07 15:27:59 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
main/BUILD.md
Rod S 124c7d40bb Update for unicode 16.0
2024-10-02 15:18:02 -07:00

3.5 KiB
Raw Blame History

Build instructions

Typically build the CBDT then the COLRv1 as COLRv1 copies some information from CBDT.

Is this a Unicode rev?

Update version

Edit NotoColorEmoji.tmpl.ttx.tmpl

  • In <head> find fontRevision.
    • It should be of the form 2.xxx
    • Increment xxx by 1
  • In <name> find <namerecord nameID="5" platformID="3" platEncID="1" langID="0x409">
    • It should look like Version 2.017;GOOG;noto-emoji:20180810:f1da3bc656f9
    • Update Version to match <head> (Version 2.017 in the example)
    • Update the date (20180810 in the example)
    • Update the commit

Update new flags

  • Add new flags to list in Makefile (example)
  • Update third_party/region-flags. For example, for CQ (Sark) update:
    • third_party/region-flags/png/CQ.png
      • This file can be highres, it will be resized by the CBDT build process
      • This file should have the proportions of the flag
    • third_party/region-flags/svg/CQ.svg
      • This file is not required to have the 0 0 128 128 viewbox files in /svg have to have
    • third_party/region-flags/waved-svg/emoji_u1f1e8_1f1f6.svg

CBDT

rm -rf venv  # in case you have an old borked venv!
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python size_check.py
rm -rf build/ && time make -j 48
# Should take 2-3 minutes to create noto-emoji/NotoColorEmoji.ttf

mv *.ttf fonts/

# make noflags CBDT font
rm fonts/NotoColorEmoji-noflags.ttf
python drop_flags.py fonts/NotoColorEmoji.ttf

COLRv1

# If you are updating to a new Unicode rev, update configs
python colrv1_generate_configs.py
git diff colrv1/*.toml

# Compile the fonts
(cd colrv1 && rm -rf build/ && time nanoemoji *.toml)
cp colrv1/build/NotoColorEmoji.ttf fonts/Noto-COLRv1.ttf
cp colrv1/build/NotoColorEmoji-noflags.ttf fonts/Noto-COLRv1-noflags.ttf

# Post-process them
python colrv1_postproc.py

Emojicompat

# Add support for new sequences per https://github.com/googlefonts/emojicompat#support-new-unicode-sequences
# Install https://github.com/googlefonts/emojicompat in a venv
# Create emojicompat versions of the fonts you made
# Starting from the root of noto-emoji-next:

$ pushd fonts
$ cp NotoColorEmoji.ttf NotoColorEmoji-emojicompat.ttf
$ cp Noto-COLRv1.ttf Noto-COLRv1-emojicompat.ttf
$ emojicompat --op setup --font NotoColorEmoji-emojicompat.ttf
$ emojicompat --op setup --font Noto-COLRv1-emojicompat.ttf
$ emojicompat --op check --font NotoColorEmoji-emojicompat.ttf
$ emojicompat --op check --font Noto-COLRv1-emojicompat.ttf

# The emojicompat --op check step should print something akin to:
3835 items_by_codepoints
0 PUA missing
0 PUA point at wrong glyph
3835 PUA correct
0 Emji entries did NOT match a glyph

Flags only

$ hb-subset --unicodes-file=flags-only-unicodes.txt \
	--output-file=fonts/NotoColorEmoji-flagsonly.ttf \
	fonts/NotoColorEmoji.ttf
$ python update_flag_name.py