2013-09-09 07:35:57 +00:00
|
|
|
# Source code directory structure
|
|
|
|
|
2013-08-14 22:43:35 +00:00
|
|
|
## Overview
|
|
|
|
|
2013-08-29 14:37:51 +00:00
|
|
|
The source code of atom-shell is separated into a few parts, and we are mostly
|
|
|
|
following Chromium on the separation conventions.
|
2013-08-14 22:43:35 +00:00
|
|
|
|
2013-08-29 14:37:51 +00:00
|
|
|
You may need to become familiar with [Chromium's multi-process
|
|
|
|
architecture](http://dev.chromium.org/developers/design-documents/multi-process-architecture)
|
|
|
|
to understand the source code better.
|
2013-08-14 22:43:35 +00:00
|
|
|
|
|
|
|
## Structure of source code
|
|
|
|
|
2014-03-16 01:17:45 +00:00
|
|
|
* **atom** - Source code of atom-shell.
|
2014-05-04 12:15:20 +00:00
|
|
|
* **app** - System entry code.
|
2014-03-16 01:17:45 +00:00
|
|
|
* **browser** - The frontend including the main window, UI, and all browser
|
|
|
|
side things. This talks to the renderer to manage web pages.
|
2014-05-04 12:15:20 +00:00
|
|
|
* **lib** - Javascript part of browser sidde initialization code.
|
2014-03-16 01:17:45 +00:00
|
|
|
* **ui** - Implementation of UI stuff for different platforms.
|
|
|
|
* **cocoa** - Cocoa specific source code.
|
|
|
|
* **gtk** - GTK+ specific source code.
|
|
|
|
* **win** - Windows GUI specific source code.
|
|
|
|
* **default_app** - The default page to show when atom-shell is started
|
|
|
|
without providing an app.
|
|
|
|
* **api** - The implementation of browser side APIs.
|
|
|
|
* **lib** - Javascript part of the API implementation.
|
|
|
|
* **net** - Network related code.
|
2014-05-04 12:15:20 +00:00
|
|
|
* **mac** - Mac specific Objective-C source code.
|
|
|
|
* **resources** - Icons, platform-dependent files, etc.
|
|
|
|
* **renderer** - Code that runs in renderer process.
|
2014-03-16 01:17:45 +00:00
|
|
|
* **lib** - Javascript part of renderer initialization code.
|
|
|
|
* **api** - The implementation of renderer side APIs.
|
|
|
|
* **lib** - Javascript part of the API implementation.
|
|
|
|
* **common** - Code that used by both browser and renderer, including some
|
2014-05-04 12:15:20 +00:00
|
|
|
utility functions and code to integrate node's message loop into Chromium's
|
|
|
|
message loop.
|
2014-03-16 01:17:45 +00:00
|
|
|
* **lib** - Common Javascript initialization code.
|
|
|
|
* **api** - The implementation of common APIs, and foundations of
|
|
|
|
atom-shell's built-in modules.
|
|
|
|
* **lib** - Javascript part of the API implementation.
|
2014-05-04 12:15:20 +00:00
|
|
|
* **chrome** - Source code modified from Chromium's `chrome` component.
|
|
|
|
* **docs** - Documentations.
|
|
|
|
* **spec** - Automatic tests.
|
|
|
|
* **atom.gyp** - Building rules of atom-shell.
|
|
|
|
* **common.gypi** - Compiler specific settings and building rules for other
|
|
|
|
components like `node` and `breakpad`.
|
2013-08-14 22:43:35 +00:00
|
|
|
|
|
|
|
## Structure of other directories
|
|
|
|
|
2014-05-04 12:15:20 +00:00
|
|
|
* **script** - Scripts used for development purpose like building, packaging,
|
|
|
|
testing, etc.
|
|
|
|
* **tools** - Helper scripts used by gyp files, unlike `script`, scripts put
|
|
|
|
here should never be invoked by users directly.
|
|
|
|
* **vendor** - Source code of third party dependencies, we didn't use
|
|
|
|
`third_party` as name because it would confuse with the same directory in
|
|
|
|
Chromium's source code tree.
|
|
|
|
* **node_modules** - Third party node modules used for building.
|
|
|
|
* **out** - Temporary output directory of `ninja`.
|
2013-08-29 14:37:51 +00:00
|
|
|
* **dist** - Temporary directory created by `script/create-dist.py` script
|
|
|
|
when creating an distribution.
|
2014-05-04 12:15:20 +00:00
|
|
|
* **frameworks** - Downloaded binaries of third-party frameworks, binaries
|
|
|
|
here are usually either closed source or hard to be built via `gyp`.
|