From 6bf0a5cb5034a7e684dcc3500e841785237ce2dd Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 19:32:43 +0200 Subject: Adding upstream version 1:115.7.0. Signed-off-by: Daniel Baumann --- browser/branding/docs/UpdatingMacIcons.rst | 31 ++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 browser/branding/docs/UpdatingMacIcons.rst (limited to 'browser/branding/docs/UpdatingMacIcons.rst') diff --git a/browser/branding/docs/UpdatingMacIcons.rst b/browser/branding/docs/UpdatingMacIcons.rst new file mode 100644 index 0000000000..b55d80cffe --- /dev/null +++ b/browser/branding/docs/UpdatingMacIcons.rst @@ -0,0 +1,31 @@ +.. _updatingmacicons: + +==================== +Updating macOS Icons +==================== + +macOS icons are stored as ``icns`` files that contain the same logo in multiple different sizes and DPIs. Apple's `Human Interface Guidelines `_ should be consulted for the specifics. + +Although it may seem like we can simply be handed the highest resolution/DPI version and downscale for the remainder -- this is not the case, some finer details in the icons (most notably shadows) need to be tweaked for each size. The UX team should hand off PNGs for every size and DPI needed. + +Once those are in hand, the ``icns`` file can be created with something like the following: + +:: + + mkdir firefox.iconset + mv icon_16x16.png firefox.iconset + mv icon_32x32.png firefox.iconset + mv icon_32x32@2x.png firefox.iconset + mv icon_64x64@2x.png firefox.iconset + mv icon_128x128.png firefox.iconset + mv icon_256x256 firefox.iconset + mv icon_256x256@2x.png firefox.iconset + mv icon_512x512.png firefox.iconset + mv icon_512x512@2x.png firefox.iconset + mv icon_1024x1024@2x.png firefox.iconset + iconutil -c icns firefox.iconset + + +(The ``NxN`` part is obviously the resolution, and the ``@2x`` string is used in the high DPI versions.) + +This will create a ``firefox.icns`` file. You can verify that it includes all of the necessary resolutions and DPIs by inspecting it with ``Preview.app``. You will likely need to do this for all brandings (``official``, ``aurora``, ``nightly``, and ``unofficial`` at the time of writing). -- cgit v1.2.3