blob: 0347fe7ad111746fd8afbfdcab93119415ebda1a [file] [log] [blame]
Satoru Takabayashibc26c612011-08-12 16:44:16 -07001This repository (system_api.git) contains constants and definitions like
2D-Bus service names that are shared between Chromium and Chromium OS.
3
4This repository is only for things like headers and .proto files.
5No implementation should be added.
Ryan Harrisond27a4892012-02-06 13:42:39 -05006
7When writting a .proto file make sure to use:
8"option optimize_for = LITE_RUNTIME;"
9
10This will force usage of a lite protobuf instead of a full/heavy weight
11protobuf. The browser only links against the light version, so you will get
12cryptic link errors about missing parts of Message if you define a protobuf here
13and then try to use it in Chrome. Currently CrOS links against the full
14protobuffer library, but that might change in the future.
15
16When declaring a protobuf, avoid use of required unless it is exactly what you
17mean. "Required is Forever" and very rarely should actually be used. Consult
18http://code.google.com/apis/protocolbuffers/docs/cpptutorial.html for a detailed
19of this issue.