google_chrome_branded_builds.md

Google Chrome branded builds

Note: to do any of this, an src-internal checkout is needed. For more info, see http://go/chrome-linux-build#optional-add-src-internal-to-the-checkout

By default, chromium will build with the open source chromium assets and branding (is_chrome_branded = false in GN args, see also Chrome vs. Chromium).

The main reason for this is that the Google Chrome logo and related assets is a trademark which we don't want to release under Chromium's open source license.

Therefore, if you want to add a trademarked resource, check it into an internal repository (see section below), and pick a resource based on the branding. To query in code whether the current build is branded, use:

• GN: is_chrome_branded
• C++: #if BUILDFLAG(GOOGLE_CHROME_BRANDING)
• Java: BuildConfig.IS_CHROME_BRANDED
• Grit: <if expr="_google_chrome">

If possible, check an open source version into Chromium, so the feature continues to work as expected in the open source build.

E.g. //components/resources/default_100_percent/chromium vs //components/resources/default_100_percent/google_chrome.

For strings, it’s ok to check them into the open source repository, but make sure that you refer to the correct product, i.e., check in a version of the string that says “Google Chrome” and a version that says “Chromium”.

E.g. //chrome/app/chromium_strings.grd vs //chrome/app/google_chrome_strings.grd.

Internal asset repositories

Assets live in various locations based on where they are used: native vs WebUI, chrome vs component layer, etc. You can read more about this here: chromium.org | High DPI Resources

To check in product-specific assets, in general:

• Add //chrome ones under //chrome/app/theme[/optional_scale_factor_indicator]/[product_name]. E.g. //chrome/app/theme/default_100_percent/chromium/product_logo_32.png

  Note: WebUI-specific resources should go under //chrome/browser/resources/[/optional_scale_factor_indicator]/[product_name]. We don't have an internal repo associated yet, so please create one if the use case comes up.

• Add //components ones under //components/resources[/optional_scale_factor_indicator]/[product_name]. E.g. //components/resources/default_200_percent/chromium/product_logo.png

Each google_chrome version of a product directory points to a separate internal git repo. Some examples:

• https://chrome-internal.googlesource.com/chrome/theme/google_chrome/
• https://chrome-internal.googlesource.com/chrome/theme/default_100_percent/google_chrome/
• https://chrome-internal.googlesource.com/chrome/components/default_200_percent/google_chrome/

To add resources there, cd to this repo, add your new assets and git cl upload to start an internal code review. Once it lands, you will need to create a new roll CL for the //../src/DEPS, using roll-dep. To do this create a new CL and from your src directory run roll-dep src/[path_to_changed_directory]. E.g. roll-dep src/chrome/app/theme/google_chrome (example manual roll CL)

Internal Clank assets

Internal Clank assets live in Clank's internal downstream repo. In general, to check in product-specific assets:

• Add //components ones under //components/[product_name]/java/res/drawable/[asset_name]. E.g. //components/page_info/java/res/drawable/product_logo.png

To add assets there, cd to this repo, add your new assets and git cl upload to start an internal code review. Once it lands, an auto-roller bot will update the main repo's src/clank hash reference in //DEPS (example autoroll CL) and your new internal assets will be available on the bots. The chromium-side CL making use of it can then be uploaded.

The internal asset is only available on a Chrome branded build. We can not utilize icons from the internal repo directly from Java because the assets wouldn't be available in public builds. We can work around this by passing the resource id to the native side and then back to Java (example CL1, CL2).