mirror of
https://github.com/zhigang1992/react-navigation.git
synced 2026-01-12 17:43:08 +08:00
72 lines
4.8 KiB
Markdown
72 lines
4.8 KiB
Markdown
# React Navigation 5
|
|
|
|
[![Build Status][build-badge]][build]
|
|
[![Code Coverage][coverage-badge]][coverage]
|
|
[![MIT License][license-badge]][license]
|
|
|
|
Routing and navigation for your React Native apps.
|
|
|
|
Documentation can be found at [reactnavigation.org](https://reactnavigation.org/).
|
|
|
|
If you are looking for version 4, the code can be found in the [4.x branch](https://github.com/react-navigation/react-navigation/tree/4.x).
|
|
|
|
## Package Versions
|
|
|
|
| Name | Latest Version |
|
|
| ------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|
|
| [@react-navigation/core](/packages/core) | [](https://www.npmjs.com/package/@react-navigation/core) |
|
|
| [@react-navigation/native](/packages/native) | [](https://www.npmjs.com/package/@react-navigation/native) |
|
|
| [@react-navigation/routers](/packages/routers) | [](https://www.npmjs.com/package/@react-navigation/routers) |
|
|
| [@react-navigation/stack](/packages/stack) | [](https://www.npmjs.com/package/@react-navigation/stack) |
|
|
| [@react-navigation/drawer](/packages/drawer) | [](https://www.npmjs.com/package/@react-navigation/drawer) |
|
|
| [@react-navigation/material-top-tabs](/packages/material-top-tabs) | [](https://www.npmjs.com/package/@react-navigation/material-top-tabs) |
|
|
| [@react-navigation/material-bottom-tabs](/packages/material-bottom-tabs) | [](https://www.npmjs.com/package/@react-navigation/material-bottom-tabs) |
|
|
| [@react-navigation/bottom-tabs](/packages/bottom-tabs) | [](https://www.npmjs.com/package/@react-navigation/bottom-tabs) |
|
|
| [@react-navigation/devtools](/packages/devtools) | [](https://www.npmjs.com/package/@react-navigation/devtools) |
|
|
|
|
## Contributing
|
|
|
|
Please read through our [contribution guide](CONTRIBUTING.md) to get started!
|
|
|
|
## Installing from a fork on GitHub
|
|
|
|
Since we use a monorepo, it's not possible to install a package from the repository URL. If you need to install a forked version from Git, you can use [`gitpkg`](https://github.com/ramasilveyra/gitpkg).
|
|
|
|
First install `gitpkg`:
|
|
|
|
```sh
|
|
yarn global add gitpkg
|
|
```
|
|
|
|
Then follow these steps to publish and install a forked package:
|
|
|
|
1. Fork this repo to your account and clone the forked repo to your local machine
|
|
1. Open a Terminal and `cd` to the location of the cloned repo
|
|
1. Run `yarn` to install any dependencies
|
|
1. If you want to make any changes, make them and commit
|
|
1. Now `cd` to the package directory that you want to use (e.g. `cd packages/stack` for `@react-navigation/stack`)
|
|
1. Run `gitpkg publish` to publish the package to your repo
|
|
|
|
After publishing, you should see something like this:
|
|
|
|
```sh
|
|
Package uploaded to git@github.com:<user>/<repo>.git with the name <name>
|
|
```
|
|
|
|
You can now install the dependency in your project:
|
|
|
|
```sh
|
|
yarn add <user>/<repo>.git#<name>
|
|
```
|
|
|
|
Remember to replace `<user>`, `<repo>` and `<name>` with right values.
|
|
|
|
<!-- badges -->
|
|
|
|
[build-badge]: https://img.shields.io/circleci/project/github/react-navigation/react-navigation/main.svg?style=flat-square
|
|
[build]: https://circleci.com/gh/react-navigation/react-navigation
|
|
[coverage-badge]: https://img.shields.io/codecov/c/github/react-navigation/react-navigation.svg?style=flat-square
|
|
[coverage]: https://codecov.io/github/react-navigation/react-navigation
|
|
[license-badge]: https://img.shields.io/npm/l/@react-navigation/core.svg?style=flat-square
|
|
[license]: https://opensource.org/licenses/MIT
|