Skip to content

docs: add platforms overview index and custom evergreen setup guide#11512

Open
AIdrifter wants to merge 1 commit into
youtube:mainfrom
AIdrifter:docs-platform-overview
Open

docs: add platforms overview index and custom evergreen setup guide#11512
AIdrifter wants to merge 1 commit into
youtube:mainfrom
AIdrifter:docs-platform-overview

Conversation

@AIdrifter

Copy link
Copy Markdown

Add a single centralized overview index (site/docs/development/index.md) providing:

  • A comparison matrix of supported platforms (Linux, Android TV, RDK, Docker tooling).
  • A 3-stage recommended development workflow.
  • Custom Evergreen path configurations and parameter mapping reference table for SoC partners.
  • Step-by-step guide for SoC partners to build and compress custom debug Cobalt Core packages locally using host lz4_compress.

Bug: 537982944

@github-actions

Copy link
Copy Markdown
Contributor

🤖 Gemini Suggested Commit Message


docs: Add development index and Evergreen guide

Add a centralized development overview index to improve the developer
onboarding experience. This includes a comparison matrix of supported
platforms, recommended workflows, and detailed configurations for
Evergreen path mapping. It specifically provides SoC partners with
instructions for building and compressing custom debug Cobalt Core
packages locally.

Bug: 537982944

💡 Pro Tips for a Better Commit Message:

  1. Influence the Result: Want to change the output? You can write custom prompts or instructions directly in the Pull Request description. The model uses that text to generate the message.
  2. Re-run the Generator: Post a comment with: /generate-commit-message

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a new development and build platforms overview document (cobalt/site/docs/development/index.md) for Cobalt, detailing supported platforms, recommended workflows, and custom Evergreen setup instructions. Feedback was provided to correct the GN build target from cobalt_loader to cobalt lz4_compress to properly compile the Cobalt Core shared library and ensure the availability of the compression tool.

Comment thread cobalt/site/docs/development/index.md Outdated

2. **Compile Uncompressed Cobalt Core & Resources**:
```bash
autoninja -C out/<platform>_devel cobalt_loader

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The target cobalt_loader is incorrect. In Cobalt's Evergreen architecture, the target to compile the Cobalt Core shared library (libcobalt.so) and its resources is cobalt (or cobalt_install), whereas loader_app is the target for the loader executable itself. Since this step is intended to generate libcobalt.so and the resource files, the target should be updated to cobalt. Additionally, explicitly building the host tool lz4_compress ensures it is available for the optional compression step below.

Suggested change
autoninja -C out/<platform>_devel cobalt_loader
autoninja -C out/<platform>_devel cobalt lz4_compress

@AIdrifter
AIdrifter force-pushed the docs-platform-overview branch 2 times, most recently from 96557ef to b97c3f7 Compare July 25, 2026 10:55
Add a single centralized overview index (site/docs/development/index.md)
providing:
- A comparison matrix of supported platforms (Linux, Android TV, RDK, Docker tooling).
- A 3-stage recommended development workflow.
- Custom Evergreen path configurations and parameter mapping reference table for SoC partners.
- Step-by-step guide for SoC partners to build and compress custom debug Cobalt Core packages locally using host lz4_compress.

Bug: 537982944
@AIdrifter
AIdrifter force-pushed the docs-platform-overview branch from b97c3f7 to ee93f69 Compare July 27, 2026 09:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant