Chromium 문서 | OSSCA Chromium

이 문서는 Chromium Docs README(docs/README.md) 문서의 한국어 전체 번역입니다.

이 디렉터리에는 chromium 프로젝트
문서가 Gitiles-flavored Markdown 형식으로 들어 있습니다. 이 문서는 자동으로
Gitiles에 의해 렌더링됩니다.

새 문서를 추가하는 경우, 아래 문서 색인에도 해당 문서로 가는 링크를 추가해 주세요.

문서 작성하기

지침

Chromium 문서화 지침 및
Chromium 문서화 모범 사례를 참고하세요.
Markdown 문서는
Markdown 스타일
가이드를 따라야 합니다.

변경 사항 미리 보기

로컬에서 md_browser 사용

# chromium 체크아웃 안에서
./tools/md_browser/md_browser.py

이는 어디까지나 추정치입니다. gitiles 보기는 다를 수 있습니다.

Gerrit의 gitiles 링크를 통해 온라인에서

패치를 gerrit에 업로드하거나, 리뷰 요청을 받습니다.
예: https://chromium-review.googlesource.com/c/3362532
특정 .md 파일을 봅니다.
예: https://chromium-review.googlesource.com/c/3362532/2/docs/README.md
페이지 왼쪽 위에 다음과 같은 것이 보입니다.

Base
preview
-> Patchset 3
preview
| DOWNLOAD

현재 패치 세트의 미리 보기를 열려면 두 번째
"preview"
링크를 클릭합니다.

이 gitiles 보기가 권위 있는 보기이며, 커밋되었을 때 사용되는 것과 정확히 동일합니다.

문서 색인

참고: 이것은 모든 문서의 완전한 목록이 아닙니다.

체크아웃과 빌드

Linux 빌드 지침 - Linux
Mac 빌드 지침 - MacOS
Windows 빌드 지침 - Windows
Android 빌드 지침 - Android 대상
(Linux 호스트에서)
Cast 빌드 지침 - Cast 대상
(Linux 호스트에서)
Android용 Cast 빌드 지침 -
Android용 Cast (Linux 호스트에서)
Fuchsia 빌드 지침 -
Fuchsia 대상 (Linux 호스트에서)
iOS 빌드 지침 - iOS 대상 (MacOS
호스트에서)
Gerrit 가이드 - Gerrit 접근 설정
Gerrit ReAuth - Gerrit ReAuth 가이드
Chrome OS 빌드 지침 - Chrome OS
Linux Chromium ARM 레시피 - Linux에서
ARM용 Chromium을 빌드하기 위한 레시피.
Chrome Component Build - 더 많은 라이브러리를 사용한
더 빠른 빌드
Cr 사용자 매뉴얼 - Chromium 작업에 사용되는 일부 도구를
추상화 계층 뒤로 숨기려는 도구인 cr의 매뉴얼

설계 문서

design/README.md를 참고하세요

통합 개발 환경(IDE) 설정 가이드

Android Studio - Android 빌드를 위한 Android Studio
Atom - Atom 멀티플랫폼 코드 편집기
CLion - CLion IDE, GUI 디버깅 지원.
Eclipse for Android - Android용 Eclipse
Eclipse for Linux - 다른 플랫폼용 Eclipse
(이 가이드는 Linux용으로 작성되었지만, Windows/MacOS에서도 아마 사용할 수 있습니다)
EMACS 노트 - EMACS 명령/스타일/도구 통합
Qt Creator - Qt Creator를 IDE 또는 GUI 디버거로 사용하기
Visual Studio Code - Visual Studio Code

Git

Git Cookbook - 일반적인 작업을 위한 git 레시피 모음
Git 팁 - 더 많은 git 팁
Git submodules - Git 서브모듈(팁, FAQ)

Clang

Clang 컴파일러 - Mac과 Linux에서 기본으로 사용되는 clang 컴파일러에 대한 일반 정보
Clang 도구 리팩터링 - AST를 인식하는 리팩터링을 수행하기 위해 clang 도구 활용하기
Clang 정적 분석기 - 빌드 시점에 정적 분석을 활성화하는 방법
Clang 코드 커버리지 래퍼 - 소스 파일의 일부에 대해 Clang 코드 커버리지 계측 활성화.
Clang 플러그인 작성 - clang 플러그인은 작성하지 마세요. 하지만 작성한다면 이것을 읽으세요
Clang 업데이트 - 빌드에 사용되는 Clang 버전 업데이트
Chromium C++ 코드에서 clang-format 사용하기 - C++ 코드에 clang-format을 호출하는 다양한 방법
Clang Tidy - Chromium에서 clang-tidy 도구 지원
Clang Format 바이너리 업데이트 - Chromium 체크아웃에 포함되는 clang-format 바이너리를 업데이트하는 방법

일반 개발

Chromium에 기여하기 - Chromium 코드베이스에 기여하기 위한 참조 워크플로 프로세스.
커밋 체크리스트 - Gerrit에 CL을 업로드하기 전에 거치는 간소화된 체크리스트.
코드 리뷰 - 코드 리뷰 요구사항 및 지침
의존성 관리 - 의존성 관리(DEPS, git 서브모듈)
존중하는 코드 리뷰 - 코드 리뷰어를 위한 가이드
존중하는 변경 - 코드 작성자를 위한 가이드
의무 코드 리뷰 롤아웃 - 코드 리뷰 및 OWNERS와 관련된 예정된 정책 변경
LUCI 마이그레이션 FAQ - Chromium의 Buildbot에서 LUCI로 빌더를 마이그레이션하는 것에 대한 FAQ
지속적 통합 UI 둘러보기 - 지속적 통합 시스템인 LUCI의 사용자 인터페이스 둘러보기
테스트 결과 파싱 - polygerrit 및 CI 빌드가 내보내는 결과를 이해하는 방법에 대한 소개.
Closure 컴파일 - Closure JavaScript 컴파일러
Chrome의 스레딩과 태스크 - Chrome에서 태스크를 실행하고 스레드 안전성을 처리하는 방법.
Callback<> 및 Bind() - Callback, Closure, Bind()에 관한 모든 것.
Chromium Views UI - 데스크톱 UI 프레임워크로 작업하기.
Views 플랫폼 스타일링 - 서로 다른 네이티브 플랫폼에 맞도록 view가 스타일링되는 방법
Tab Helpers - WebContents/WebContentsObserver를 사용해 브라우저 탭에 기능 추가하기.
third_party 라이브러리 추가 - 코드를 third_party/에 넣는 방법
Chromium Views용 그래픽 디버깅 보조 도구 - 디버깅 중 view 트리 시각화하기
Bitmap Pipeline - 비트맵이 렌더러에서 화면으로 이동하는 방법.
Flag Guarding 지침 - 변경 사항을 안전하게 롤아웃하기 위해 서버 제어 kill switch와 A/B 실험을 언제 사용할지.
Origin Trials 프레임워크 사용 - 테스트를 위해 실험적 API를 조건부로 활성화하는 프레임워크.
Chrome Sync -
여러 기기 간에 데이터를 동기화할 수 있게 해 주는 하위 시스템 문서.
Ozone 개요 - Ozone은 윈도 시스템과 저수준 입력 및 그래픽 사이의 추상화 계층입니다.
프로젝트 계획에서 브랜치 날짜를 고려하기 위한 지침 -
프로젝트 작업 일정을 잡을 때 브랜치 날짜 전후에 해야 할 일과 하지 말아야 할 일.
Watchlists - 관심 있는 CL 알림을 받기 위해 watchlist 사용하기.
Shutdown - 새 종료 작업을 어디에 추가할지 더 쉽게 판단할 수 있도록 Chrome 종료의 단계 설명.
API Keys - 커스텀 빌드, 포크, stock Chromium 통합을 위해 Google API 접근이 필요하거나 ChromiumOS(로그인용)를 빌드하는 경우.
User Education - Chromium 기능을 강조하기 위한 제품 내 도움말(IPH)과 튜토리얼 만들기.
User-Agent - User-Agent 및 User-Agent Client Hints.

테스트

웹 테스트 실행 및 디버깅
테스트 비활성화에 관하여
웹 테스트 작성 - content_shell을 사용하는 웹 테스트
웹 테스트 기대값 및 기준선 - 웹 테스트의 예상 결과 설정.
웹 테스트 팁 - 웹 테스트 모범 사례
수동 폴백이 있는 웹 테스트 - 수동 개입을 시뮬레이션하는 테스트 작성
웹 테스트 프레임워크 확장
웹 테스트 플래키함 수정 -
순서 의존성으로 인한 웹 테스트 플래키함 진단 및 수정.
content_shell을 사용한 웹 테스트 실행 -
웹 테스트를 직접 실행하기.
Web Platform Tests - 브라우저 벤더 간 공유 테스트
content_shell에서 Crashpad 사용 -
디버거가 연결되지 않은 레이아웃 테스트 크래시에서 스택 트레이스 캡처
테스트 설명 - 빌드 가능한 단위 테스트 대상과 관련 설명.
Fuzz Testing - Chromium의 퍼즈 테스트.
AddressSanitizer(asan) 및 LeakSanitizer(lsan)로 Chrome 테스트 실행 -
주소 지정 문제와 메모리 누수를 감지하기 위해 ASAN 및 LSAN 빌드로 Chrome 테스트 실행.
코드 커버리지 - Chromium의 코드 커버리지.
Gerrit의 코드 커버리지 - 코드 리뷰를 돕기 위한 Gerrit의 CL별 코드 커버리지.
Chrome for Testing - 표준 Chrome과 비교한 Chrome for Testing의 기능적 및 동작상 차이.
Chrome for Testing 구성 - Chrome for Testing 필수 구성요소 설치 및 UI 동작 사용자 지정.

구성 문서

구성: Prefs, Settings, Features, Switches & Flags - 새 기능을 게이트하는 다양한 방법 설명.
chrome://flags에 새 feature flag 추가 - 기능을 실험하기 위해 새 feature flag를 추가하는 빠른 가이드.
Runtime Enabled Features
content 계층에서 Blink 런타임 기능 초기화
origin trials 프레임워크와 기능 통합
Origin-Trial로 제어되는 HTML 요소를 위한 커스텀 타입 헬퍼

GPU 관련 문서

GPU Pixel Wrangling - GPU
pixel wrangling(GPU sheriffing 로테이션)을 위한 지침.
GPU 관련 코드 디버깅 - GPU 및 그래픽 관련 코드 디버깅 힌트.
GPU Testing - Chromium의 GPU 테스트 인프라 설명.
GPU Bot Details - 봇이 유지관리되는 방법에 대한 심층 설명.

기타 Linux 전용 문서

Linux Proxy Config - Linux의 네트워크 프록시 소스
Linux에서 SSL 디버깅 - Linux에서 SSL 코드 디버깅 팁
Linux Cert Management - Linux에서 X.509 인증서 관리
Linux에서 디버깅 팁
Linux GTK Theme Integration - Chrome이 GTK+ 테마와 어울리도록 하기.
Linux의 브라우저 플러그인 - Linux에서 브라우저 플러그인이 작동하는 방식에 대한 정보 링크 모음
Linux Crash Dumping - Breakpad가 Google 크래시 서버에 크래시 보고서를 업로드하는 방법.
Linux Minidump to Core - Breakpad가 생성한 미니덤프 파일을 대부분의 디버거가 읽을 수 있는 코어 파일로 변환하는 방법
Linux Sandbox IPC - 콜 스택의 아래쪽에서 브라우저까지 요청을 라우팅하는 데 사용되는 저수준 UPC 시스템.
Linux Dev Build as Default Browser -
Linux에서 Chrome Dev 빌드를 기본 브라우저로 구성하는 방법.
Linux Chromium Packages - 일부 Linux 배포판에서 제공하는 Chromium 브라우저(Chrome 아님) 패키지.
seccomp Sandbox Crash Dumping - seccomp 샌드박스에서 실행 중인 프로세스의 크래시 덤프에 관한 노트.
Linux Password Storage - Chromium과 Linux 사이의 키체인 통합.
Linux Sublime Development - Linux에서 Chromium 개발을 위해 Sublime을 IDE로 사용하기.
GTK 빌드 및 디버깅 - 낮은 최적화 수준 및/또는 더 많은 디버깅 심벌을 사용해 GTK에 대해 Chromium 빌드하기.
GTK 디버깅 - GTK Debug 패키지 및 관련 도구 사용.
Chroot 노트 - 일부 Linux 버전의 libfreetype 차이를 우회하기 위해 chroot 설정하기.
Linux Sandboxing - 서로 다른 권한을 가진 브라우저 구성요소를 격리하기 위한 Linux 멀티프로세스 모델.
Zygote Process - 새 프로세스를 생성하는 데 사용되는 Linux Zygote 프로세스의 작동 방식.
Linux에서 웹 테스트 실행 - 웹 테스트 실행을 위한 Linux 전용 지침.
Linux Sysroot Images - 빌드가 Linux에서 라이브러리를 사용하는 방법
Linux Hardware Video Decoding - Linux에서 하드웨어 비디오 디코드 코드 경로 활성화

기타 MacOS 전용 문서

Mac 디버깅 팁 - Mac에서의 디버깅 소개 및 유용한 팁 모음.
Mac에서 CCache 사용 - ccache와 clang/ninja를 사용해 Mac에서 빌드 속도 높이기
Cocoa tips and tricks - Cocoa view와 controller를 작성할 때 사용되는 관용구 모음

기타 Windows 전용 문서

cygwin rebaseall 실패 처리
Chromium에서 ANGLE 해킹하기 - DirectX 위에 구축된 OpenGL ES 2.0
Windows Split DLLs - Windows의 툴체인 한계를 우회하기 위해 chrome.dll을 여러 dll로 분할하기.
Windows Native Window Occlusion Tracking
Windows PWA Integration - Windows에서 Progressive Web Apps와의 통합
Windows Shortcut and Taskbar Handling
Windows Virtual Desktop Integration

기타 Android 전용 문서

Android용 Chrome의 Google Play Services
Java에서 C++ Enum 접근 - Java 코드에서 C++로 정의된 enum을 사용하는 방법
Android에서 Content Shell 프로파일링 - Android에서 content_shell 프로파일링 설정
Android로 원격 작업 - 로컬 머신에 연결된 Android 기기를 대상으로 원격 머신에서 빌드하기
Android 테스트 지침 - Android 기기 또는 에뮬레이터에서 빌드 실행.
Android 디버깅 - Android에서 실행되는 Java 및/또는 C/C++ 코드를 디버깅하는 도구와 팁.
Android Logging - Chrome의 logging API가 Android의 android.util.Log와 함께 작동하는 방식 및 사용 지침.
Android Java 정적 분석 - 'lint' 도구로 컴파일 시점에 Java 관련 문제 포착하기.
Java Code Coverage - EMMA 도구로 코드 커버리지 데이터 수집.
Dynamic Feature Modules (DFMs) - 이것들이 무엇이며 새 모듈을 만드는 방법.
기타 빌드 관련 Android 문서
Android용 Chrome UI - UI 개발을 위한 리소스 및 모범 사례

기타 iOS 전용 문서

iOS용 Chromium의 지속적 빌드 및 테스트 인프라
iOS용 Chrome에서 링크 열기 - iOS 앱이 Chrome에서 링크를 열도록 하는 방법.
iOS용 Chrome의 User Agent - iOS용 Chrome에서 사용하는 User Agent 문자열에 관한 노트.
로컬에서 iOS 테스트 스위트 실행
iOS에서 프로젝트 파일 작업 - iOS Chromium 프로젝트에서 파일을 추가, 제거, 이름 변경하는 방법.

기타 Chrome-OS 전용 문서

기타 WebUI 전용 문서

WebUI Explainer - 웹 기술(즉, chrome:// URL)로 구현된 Chrome UI를 위한 C++ 및 TypeScript 인프라 코드 설명.
Chrome Web UI 최적화 - WebUI 성능을 높이기 위한 노트
WebUI의 Trusted Types - Trusted Types를 염두에 두고 WebUI에서 코딩하기 위한 팁.
chrome-untrusted:// FAQ - 신뢰할 수 없는 콘텐츠를 처리하는 WebUI를 호스팅하기 위한 chrome-untrusted:// 스킴 사용 설명.

미디어

Audio Focus Handling - 여러 MediaSession 오디오 스트림이 상호작용하는 방식
HTMLMediaElements 자동재생 - HTMLMediaElements가 자동재생되는 방식.
Latency tracing - 오디오 지연 시간을 측정하기 위해 "audio.latency" tracing 카테고리를 사용하는 방법.
Piranha Plant - MediaStreams의 미래 아키텍처
Media Capture - 브라우저가 자기 자신 또는 기반 OS에서 픽셀과 오디오를 캡처할 수 있게 하는 기능 및 API.
Video Encode Accelerator Tests - 가속 비디오 인코더 테스트 프로그램을 사용하는 방법.
Video Decoder Tests - 비디오 디코더 테스트 실행.
Video Decoder Performance Tests -
비디오 디코더 성능 테스트 실행.

접근성

접근성 개요 - Chromium의 접근성 관련 관심사와 접근 방식 개요.
접근성 테스트 - 코드베이스에서 접근성 관련 테스트를 찾을 수 있는 위치.
Chrome OS의 ChromeVox - Chrome OS에서 음성 피드백(ChromeVox) 활성화.
데스크톱 Linux의 ChromeVox - 데스크톱 Linux에서 음성 피드백(ChromeVox) 활성화.
Offscreen, Invisible and Size - Chrome이 접근성 트리에서 offscreen, invisible, size를 정의하는 방법.
Text to Speech - Chrome 및 Chrome OS의 text to speech 개요.
Chrome OS의 BRLTTY - refreshable braille display를 지원하기 위한 Chrome OS와 BRLTTY 통합
Chrome OS의 PATTS - Chrome OS에서 사용되는 PATTS 음성 합성 엔진에 관한 노트
VoiceOver - iOS의 Chromium에서 Apple의 VoiceOver 기능 사용하기.

메모리

Memory Infrastructure Timeline Profiling (MemoryInfra)

Metrics

기타

Useful URLs - 다양한 도구와 대시보드로 가는 링크 모음
ERC IRC - EMACS에서 IRC에 접근하기 위해 ERC 사용하기
Kiosk Mode - kiosk mode 시뮬레이션.
User Handle Mapping - Chromium/IRC/Google 전반에서 사용되는 개발자 이름
Documentation Best Practices
Documentation Guidelines
Chromium Browser vs Google Chrome - _Chromium Browser_와 _Google Chrome_의 차이는 무엇인가?
Google Chrome branded builds
WPAD를 사용한 Proxy Auto Config - WPAD 서버가 프록시 설정을 자동으로 지정하는 데 사용되는 방법.
VMWare에 Chromium OS 설치 - VMWare에 Chromium OS를 설치하는 방법.
User Data Directory - 모든 플랫폼에서 사용자 데이터 및 캐시 디렉터리가 결정되는 방법.
User Data Storage - User Data 안의 파일에 대한 정책 문서.

Mojo & Services

Mojo & Services 소개 - 예제와 함께 보는 Chromium의 Mojo와 서비스에 대한 빠른 소개
Mojo API Reference - Mojo 전반에 대한 자세한 참조 문서
Service Development Guidelines - Chromium 트리에서 서비스 개발을 위한 지침
Chromium 기능 서비스화 - 신규 및 기존 하위 시스템을 Chromium에 서비스로 통합하기 위한 일반 조언
Legacy IPC를 Mojo로 변환 - 실무 IPC 변환 작업을 위한 팁과 일반 패턴
Mojo “Style” Guide - Mojo 및 IPC 리뷰어가 권장하는 모범 사례
D-Bus Mojo Connection Service - CrOS 서비스의 Mojo 연결을 부트스트랩하기 위한 Chrome의 서비스.

보안

The Rule Of 2 - 신뢰할 수 없는 콘텐츠(웹에서 다운로드한 모든 것 등)를 처리할 때 중요한 보안 규칙.

속도

Chrome Speed - Chrome의 성능 측정 및 회귀에 관한 문서.
Chrome Speed Metrics - 웹의 사용자 경험 메트릭과 그 JavaScript API에 관한 문서.

안정성

stability/crash 메트릭 및 보고 개요 - Chrome이 안정성을 모니터링하고 안정성 향상을 시도하는 다양한 방식을 설명합니다.

UI

Chromium UI Platform - 사용자 인터페이스에 관한 모든 것

What's Up With That 녹취록

이것들은 Chromium 소프트웨어 엔지니어와의 인터뷰 비디오 시리즈인
What's Up With That의 녹취록입니다.

아마도 폐기된 문서

TPM Quick Reference - Trusted Platform Module 노트.
System Hardening Features - 현재 및 계획된 Chrome OS 보안 기능 목록.
WebView Policies
Linux Profiling - Linux에서 Chromium을 프로파일링하는 방법
Linux Graphics Pipeline
Linux SUID Sandbox - Linux에서 SUID 바이너리를 사용해 렌더러 샌드박싱하기
Linux SUID Sandbox Development -
위 시스템의 개발.
Linux PID Namespace Support
Vanilla msysgit workflow - Windows에서 대부분 vanilla git을 사용하는 워크플로.
Old Options - Material Design 이전 chrome://settings 노트.