# New CupertinoIcons has icon glyph changes

> Once you update to cupertino_icons 1.0.0, some old glyphs are automapped to the new glyphs. Consider double-checking visually.




:::important
These breaking change docs are accurate, as of the release
under which they are published. Over time, the
workarounds described here might become inaccurate.
We don't, in general, keep these breaking change docs up
to date as of each release.

这些破坏性改动文档的准确性仅限于其发布时对应的版本。
随着时间的推移，文档中描述的方案可能会逐渐失效。
通常情况下，我们不会在每次发布新版本时都对这些文档进行同步更新。

The [breaking change index file](/release/breaking-changes)
lists the docs created for each release.

[破坏性改动列表](/release/breaking-changes) 
列出了每个版本的文档。

:::


## Summary

The existing cupertino_icons [0.1.3 icons][]
are based on iOS 11 aesthetics with sharp angles and thin lines.

As Apple's iconography updates with new OS versions,
the `cupertino_icons` package is also refreshed.

Generally, all previous glyphs referenced from the
[`CupertinoIcons`][] API are automatically mapped to
very similar looking icons in the new SF Symbols
style (featuring rounder, thicker lines).

Some icons that have no equivalents in the
new SF Symbols style are left as is.

Some icons that have less variation
(such as thickness, alternative looks, and so on)
are automapped and collapsed to the best matching
variation in the new SF Symbols style but should be
double checked to determine whether they preserve the
intended visual effect.

## Description of change

The new `cupertino_icons 1.0.0` font is handcrafted
to best preserve the intent and aesthetic of the
symbology through the transition. All existing
`CupertinoIcons`' static `IconData` fields
(and thus all of the font `.ttf`'s codepoints)
continue to work and point to a reasonable new icon.

The new cupertino_icons 1.0.0 package also has ~1,000
more icons to choose from.

### Unchanged icons

No SF Symbols styled alternatives exist
for the icons in the following list.
The previous cupertino_icons 0.1.3 icons
have been kept as is in 1.0.0.

* bluetooth
* bus
* car
* car_detailed
* chevron_back
* chevron_forward
* lab_flask
* lab_flask_solid
* news
* news_solid
* train_style_one
* train_style_two

### Merged icons

Icons within the same group are now the exact same
icon in 1.0.0. In other words, the distinctions
between those icon variations that existed in 0.1.3 is
lost and now renders the same SF Symbols
styled icon that represents the theme of the group.

This affects the following icon groups:

* share, share_up
* battery_charging, battery_full, battery_75_percent
* shuffle, shuffle_medium, shuffle_thick
* delete, delete_simple
* refresh, refresh_thin, refresh_thick
* clear, clear_thick
* clear_circled_solid, clear_thick_circled
* gear, gear_alt, gear_big
* loop, loop_thick
* time_solid, clock_solid
* time, clock
* tag, tags
* tag_solid, tags_solid

This is mainly due to some artistic liberties taken
when creating the original `cupertino_icons` set that
no longer match the variations diversity of the more
formal SF Symbols icon set for some of the icons.

## Migration guide

After upgrading to 1.22,
if you also upgrade the `cupertino_icons`
pubspec dependency from 0.1.3 to 1.0.0,
for example, by changing:

```yaml
dependencies:
  ... // Other dependencies
  cupertino_icons: ^0.1.0
```

to:

```yaml
dependencies:
  ... // Other dependencies
  cupertino_icons: ^1.0.0
```

All your `CupertinoIcons` should automatically
update to the new aesthetic (except for the
[unchanged icons](#unchanged-icons) listed above).

At this point, you can also explore [`CupertinoIcons`][]
for new icons to use in your application.

You're encouraged to verify your application after
migrating to ensure that the automatically mapped
new icons are suitable for your desired aesthetics.

## Timeline

Landed in: 1.22.0-10.0.pre.65<br>
In stable release: 1.22

## References

[0.1.3 icons]: https://raw.githubusercontent.com/flutter/cupertino_icons/master/map.png
[`CupertinoIcons`]: https://api.flutter-io.cn/flutter/cupertino/CupertinoIcons-class.html