alibaba/freeline is a open-source project on GitHub, written primarily in Java. It has 5.4k stars. A super fast build tool for Android, an alternative to Instant Run
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Freeline is a super fast build tool for Android and an alternative to Instant Run. Caching reusable class files and resource indices, it enables incremental building Android apps, and optionally deploying the updates to your device by hot swap.
See Freeline official website for more information.
Developed and used by Ant Fortune (about us) Android Team, Freeline has been significantly saving time in daily work. Inspiring by Buck and Instant Run but faster than ever, Freeline can make an incremental build in just a few seconds. No more recompile and reinstall again and again before seeing your modifications, Freeline brings life-changing development experience for Android.
中文说明
Freeline Insights
Freeline splits the build task into several small tasks that run concurrently. It makes full use of the compiled cache files to implement a real incremental build and uses some components of Buck such as dx and DexMerger to speed up the build tasks. Freeline runs a socket server in a separate process on device side, which connects with build tool on developer's machine, so that deployment can still take effects even if the main process crashes.
Freeline uses multi-dex solution for incremental dex hot swapping. A deeply optimized version of aapt tool (FreelineAapt) is made to generate incremental resource pack, which is several times faster than the original aapt tool and the resouce pack can be as small as 1kb. MonkeyPatcher from Instant Run is utilized to make hot resource replacement. Freeline support dynamic swap native .so library, you don't need to re-build your project after native .so files changed.
Freeline will automatically switch between full build and incremental build.
Freeline is also a great basis for over-the-air hotpatching. Deliverying Freeline's incremental output, which can be packed into a zip file and usually less than 100 kb, it is able to take effect to fix crashes or other problems and replace resoucres dynamically. Statistical data over large amount cases show that it is effective for 99% of users. Please note that the OTA patch delivery system is out of scope of this project.
FreelineAapt will open source codes later. See wiki to know more about Freeline, only Chinese available now.
中文原理说明
Features
Speed up standard android gradle projects with multiple modules
Concurrent tasks that incrementally build project
Hot deploy even if the main process crashes
Build incremental dex and resource pack
Caching resource.arsc support
Running on Windows, Linux and Mac
Native so hot swap support
Annotation support
Retrolambda support
DataBinding support
See the following table for changes support.
Java
drawable, layout, etc.
res/values
native so
add
√
√
√
√
change
√
√
√
√
remove
√
√
x
-
Freeline has been tested with API versions 17, 19, 22, 23 on the android emulators, a Nexus 6p running marshmallow and a smartisan running Kitkat. Incremental resource patch would be much faster if the android device is running Lolipop or above.
Download
Configure your project-level build.gradle to include freeline plugin:
Finally, execute the gradle task initFreeline to download freeline dependencies.
Windows[CMD]: gradlew initFreeline
Linux/Mac: ./gradlew initFreeline
For Chinese users, if you got stuck in the download process, you can execute gradlew initFreeline -Pmirror to speed up the progress.
You can also use -PfreelineVersion={your-specific-version} parameter to download the specific version of freeline's python and bin dependencies.
If you have a complex project structure, you may need to use freeline DSL to customize your build process. For more details about freeline DSL, see Freeline DSL References.
Usage
You can install freeline plugin in Android Studio for quick usage.
How to install? In Android Studio, go to:
MacOS
Android Studio → Preferences... → Plugins → Browse repositories...
TopGit's last sync did not record any GitHub topics for alibaba/freeline. GitHub topics appear in the right sidebar of a repository page; that's the authoritative place to check.
How active is development on alibaba/freeline?
The most recent commit recorded on alibaba/freeline was 6.5 years ago, based on the GitHub push timestamp. The repository has 619 forks — one of the better signals of community interest.
How many stars does alibaba/freeline have?
alibaba/freeline has 5.4k GitHub stars — refresh the page for the live number, or check github.com/alibaba/freeline. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What language is alibaba/freeline written in?
alibaba/freeline is written primarily in Java. GitHub's language field is based on the largest share of bytes in the default branch.
Where do I read more about alibaba/freeline?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/alibaba/freeline is the definitive source.
Read full README in the tab above.
Still deciding about freeline?
One click hands the question to an AI along with this page — see what it says about freeline.