mirror of
https://github.com/status-im/react-native.git
synced 2025-01-15 03:56:03 +00:00
aadeff032f
Summary: Adds a new maintainers guide, and updates the contributor's guide to be consistent with regards to this new guide. Some additional style changes made in order to support the display of bot commands. Changed the wording for the "Edit this page on GitHub" link. Finally, the contributor's guide is now synced to `CONTRIBUTING.md` on the repo. ``` cd website && npm start ``` Verify that `CONTRIBUTING.md` is updated whenever the website is regenerated. Verify everything rendered correctly. Expand the details below to see screenshots. <details> ![screencapture-localhost-8079-react-native-docs-contributing-html-1501016495792](https://user-images.githubusercontent.com/165856/28593706-33d1e03c-7142-11e7-9878-04ead7561abc.png) ![screencapture-localhost-8079-react-native-docs-maintainers-html-1501016508744](https://user-images.githubusercontent.com/165856/28593719-3812d7fa-7142-11e7-9db2-f9599057d726.png) </details> Closes https://github.com/facebook/react-native/pull/15202 Differential Revision: D5494246 Pulled By: hramos fbshipit-source-id: e28d5624d1e4795e212f10e8d5713d91a0eae15f
39 lines
1.8 KiB
Markdown
39 lines
1.8 KiB
Markdown
---
|
|
id: understanding-cli
|
|
title: Understanding the CLI
|
|
layout: docs
|
|
category: Contributing
|
|
permalink: docs/understanding-cli.html
|
|
banner: ejected
|
|
next: activityindicator
|
|
previous: testing
|
|
---
|
|
|
|
Though you may have installed the `react-native-cli` via npm as a separate module, it is a shell for accessing the CLI embedded
|
|
in the React Native of each project. Your commands and their effects are dependent on the version of the module of `react-native`
|
|
in context of the project. This guide will give a brief overview of the CLI in the module.
|
|
|
|
# The local CLI
|
|
|
|
React Native has a [`local-cli`](https://github.com/facebook/react-native/tree/master/local-cli) folder with a file named
|
|
[`cliEntry.js`](https://github.com/facebook/react-native/blob/master/local-cli/cliEntry.js). Here, the commands are read
|
|
from `commands.js` and added as possible CLI commands. _E.G._ the `react-native link` command, exists in the
|
|
[`react-native/local-cli/link`](https://github.com/facebook/react-native/blob/master/local-cli/link/) folder, and is
|
|
required in `commands.js`, which will register it as a documented command to be exposed to the CLI.
|
|
|
|
# Command definitions
|
|
|
|
At the end of each command entry is an export. The export is an object with a function to perform, description of the command, and the command name. The object structure for the `link` command looks like so:
|
|
|
|
```js
|
|
module.exports = {
|
|
func: link,
|
|
description: 'links all native dependencies',
|
|
name: 'link [packageName]',
|
|
};
|
|
```
|
|
|
|
### Parameters
|
|
|
|
The command name identifies the parameters that a command would expect. When the command parameter is surrounded by greater-than, less-than symbols `< >`, this indicates that the parameter is expected. When a parameter is surrounded by brackets `[ ]`, this indicates that the parameter is optional.
|