Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/facebook/litho
A declarative framework for building efficient UIs on Android.
https://github.com/facebook/litho
Last synced: 5 days ago
JSON representation
A declarative framework for building efficient UIs on Android.
- Host: GitHub
- URL: https://github.com/facebook/litho
- Owner: facebook
- License: apache-2.0
- Created: 2017-01-27T03:59:11.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-10-29T13:11:20.000Z (3 months ago)
- Last Synced: 2024-10-29T13:27:58.289Z (3 months ago)
- Language: Kotlin
- Homepage: https://fblitho.com
- Size: 747 MB
- Stars: 7,704
- Watchers: 181
- Forks: 765
- Open Issues: 88
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-android - Litho (By Facebook) - A declarative framework for building efficient UIs on Android. (Libraries / GUI)
- awesome-list - litho
- awesome-github-android-ui - litho - 创建Android高效UI (其他)
- awesome-github-star - litho
- awesome-android - Litho (By Facebook) - A declarative framework for building efficient UIs on Android. (Libraries / GUI)
README
# Litho [](https://github.com/facebook/litho/actions/workflows/ci.yml) [](https://bintray.com/facebook/maven/com.facebook.litho%3Alitho-core/_latestVersion) [](https://gitter.im/facebook/litho?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [](https://github.com/facebook/litho/blob/master/LICENSE)
Litho is a declarative framework for building efficient UIs on Android.
* **Declarative:** Litho uses a declarative API to define UI components. You simply describe the layout for your UI based on a set of immutable inputs and the framework takes care of the rest.
* **Asynchronous layout:** Litho can measure and layout your UI ahead of time without blocking the UI thread.
* **View flattening:** Litho uses [Yoga](https://facebook.github.io/yoga/) for layout and automatically reduces the number of ViewGroups that your UI contains.
* **Fine-grained recycling:** Any component such as a text or image can be recycled and reused anywhere in the UI.
To get started, check out these links:
* [Learn how to use Litho in your project.](http://fblitho.com/docs/getting-started)
* [Get started with our tutorial.](http://fblitho.com/docs/tutorial)
* [Read more about Litho in our docs.](http://fblitho.com/docs/intro)
## Installation
Litho can be integrated either in Gradle or Buck projects. Read our [Getting Started](http://fblitho.com/docs/getting-started) guide for installation instructions.
## Quick start
### 1. Initialize `SoLoader` in your `Application` class.
```java
public class SampleApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
SoLoader.init(this, false);
}
}
```
### 2. Create and display a component in your Activity
```java
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
final ComponentContext c = new ComponentContext(this);
final Component component = Text.create(c)
.text("Hello World")
.textSizeDip(50)
.build();
setContentView(LithoView.create(c, component));
}
```
## Run sample
You can find more examples in our [sample app](https://github.com/facebook/litho/tree/master/sample).
To build and run (on an attached device/emulator) the sample app, execute
$ buck fetch sample
$ buck install -r sample
or, if you prefer Gradle,
$ ./gradlew :sample:installDebug
## Contributing
Before contributing to Litho, please first read the [Code of
Conduct](https://code.facebook.com/codeofconduct) that we expect
project participants to adhere to.
For pull requests, please see our [CONTRIBUTING](CONTRIBUTING.md) guide.
See our [issues](https://github.com/facebook/litho/issues/) page for ideas on how to contribute or to let us know of any problems.
Please also read our [Coding Style](http://fblitho.com/docs/best-practices#coding-style) and [Code of Conduct](https://code.facebook.com/codeofconduct) before you contribute.
## Getting Help
- Post on [StackOverflow](https://stackoverflow.com/questions/tagged/litho)
using the `#litho` tag.
- Chat with us on [Gitter](https://gitter.im/facebook/litho).
- Join our [Facebook Group](https://www.facebook.com/groups/litho.android/) to
stay up-to-date with announcements.
- Please open GitHub issues only if you suspect a bug in the framework or have a
feature request and not for general questions.
## License
Litho is licensed under the [Apache 2.0 License](LICENSE).