Merge pull request #1402 from unoplatform/dev/ICSI/DSP-Support-Docs
docs: Update docs with ThemeBuilder changes
This commit is contained in:
Коммит
4d87b4ccb0
Двоичные данные
doc/assets/material-theme-builder-export2.png
Двоичные данные
doc/assets/material-theme-builder-export2.png
Двоичный файл не отображается.
До Ширина: | Высота: | Размер: 14 KiB После Ширина: | Высота: | Размер: 18 KiB |
|
@ -32,18 +32,23 @@ This package will be automatically present in the project after [creating a new
|
|||
* The package is already present when you select _Material_ theme during project creation:
|
||||
![Selection of Material theme when creating a project using the Uno Template Wizard](assets/material-theme-selection-wizard.png)
|
||||
|
||||
## Generating a custom color palette and export as DSP file
|
||||
## Generating a custom color palette and exporting it as a JSON file
|
||||
|
||||
1. Navigate to the [Material Theme Builder](https://m3.material.io/theme-builder#/custom) and select the colors you want to use for your application.
|
||||
2. Locate the _Export_ button and pick the _material Tokens (DSP)_ format.
|
||||
2. Locate the _Export_ button and pick the _Material Theme (JSON)_ format.
|
||||
|
||||
![Export Button](assets/material-theme-builder-export1.png) ![DSP Selection](assets/material-theme-builder-export2.png)
|
||||
3. Save the zip file to your computer.
|
||||
4. Replace the file `ColorPaletteOverride.zip` in the `Styles` folder of your application project with the one you just downloaded.
|
||||
5. Build your application. The `ColorPaletteOverride.xaml` file will be automatically updated with the colors present in the DSP zip file.
|
||||
3. Save the file to your computer.
|
||||
4. Replace the `ColorPaletteOverride.json` file in the `Styles` folder of your application project with the one you just downloaded.
|
||||
5. Build your application. The `ColorPaletteOverride.xaml` file will be automatically updated with the colors present in the JSON file.
|
||||
|
||||
## More flexibility
|
||||
|
||||
This will generate the file at each build, potentially overriding any changes you made to the file. If you want to keep it that way, you can simply remove the `ColorPaletteOverride.zip` file from the `Styles` folder, the file won't get overwritten anymore.
|
||||
This will generate the file at each build, potentially overriding any changes you made to the file. If you want to keep it that way, you can simply remove the `ColorPaletteOverride.json` file from the `Styles` folder, the file won't get overwritten anymore.
|
||||
|
||||
Alternatively, you can also use the [Uno.Dsp.Cli](https://nuget.org/packages/Uno.Dsp.Cli) package to generate the file from the command line. This will allow you to generate the file only when you want to, and not at each build.
|
||||
|
||||
> [!NOTE]
|
||||
> Although the **Material Theme Builder Tool** doesn't export **Material Tokens (DSP)** packages anymore, the Uno Figma Plugin still supports this file format.
|
||||
> To be able to import DSP packages just follow the same steps described previously and save the downloaded DSP zip file as `ColorPaletteOverride.zip` in the `Styles` folder of your application project.
|
||||
> In that case, make sure to delete the `material-theme.json` file from `Styles` folder before building your application, to avoid conflicts.
|
||||
|
|
Загрузка…
Ссылка в новой задаче