Gradle Plugin to enable auto-completion and symbol resolution for all Kotlin/Native platforms.
This zero-configuration required Gradle plugin will allow you to comfortably write Kotlin code for all the supported targets.
Before, you had only autocompletion and symbol resolution for native APIs from your host Operating System. With CompleteKotlin, you get it for everything, regardless of your host OS:
Your host OS becomes irrelevant to writing and reading code:
- That means writing and reading iOS, iPadOS, watchOS, tvOS, and macOS code, without macOS.
- That also means writing and reading Linux MIPS code, without Linux.
- Finally, that means writing and reading Windows code, without Windows.
Enjoy developing native mobile apps, native desktop apps, and maybe even embedded systems on MIPS.
CompleteKotlin doesn't care about traffic lights, roadblocks, or even penguins, it'll just see if any platform's definitions for Kotlin are missing and will make it… complete.
It also doesn't care about droids because there's nothing incomplete there 😉.
Adding it to a Kotlin Multiplatform project is one copy/pasting, one button click, and a bit, or a lot of waiting, depending on your connection and your computer performance:
Take the build.gradle(.kts) file located at the root of your Kotlin Multiplatform project,
and add the following at the top of the file:
plugins {
id("com.louiscad.complete-kotlin") version "1.1.0"
}That will apply CompleteKotlin to all Kotlin multiplatform modules.
If you're using refreshVersions and don't want to miss any update,
you can omit the version in the snippet above, and add the following in your versions.properties file instead:
plugin.com.louiscad.complete-kotlin=1.1.0Then, make a Gradle sync/reload in the IDE with the best internet connection you have around, and once it's done, that's it! You now have complete Kotlin!
Now, you can explore the APIs from whichever platform you want, without switching computers or VMs. 😎
Important note: CompleteKotlin enables API discovery (autocompletion and symbol resolution in the IDE), but it will not enable you to compile, say a Windows app on a Mac, or an iOS app on Linux. Learn more in the FAQ below.
I found out that I like doing pair-programming remotely with folks from anywhere on the planet on open source projects. However, some projects involve platform exclusive APIs, which might mismatch with the person I want to pair with.
Same story for asynchronous collaboration. Having someone on Linux or Windows seeing red code in the IDE, with unresolved references everywhere, just because it's using some Darwin or iOS APIs is not a good developer experience.
People might not use macOS for financial reasons, by choice, or because installing macOS on their machine is a bit hard, or kinda illegal in some countries (but not in EU at least, you can do whatever with your hardware so long you're not violating other laws, and that you're not selling said hardware loaded with restricted intellectual property).
I believe these reasons should not prevent people from collaborating. Diversity often leads to better results for an ever diverse world, and everyone on almost the exact same computer doesn't sound like diversity.
When your rent is less than 3% of what it'd be in San Francisco, you don't start a project or startup by buying Macs for all the developers. Young folks in these parts of the world are no less smart than other ones, so why limit ourselves?
The most profitable markets have a share of iOS users that can rarely be ignored. I thought it'd be great that people get similar opportunities with similar effort, regardless of their local economy, so I hope this is helping and will make a positive, long-lasting impact.
Kotlin might not be perfect, but it's most likely the best designed and run high-level programming language IMHO, and it can be fun in a good way. It makes it easier to avoid bugs, including concurrency issues, so it makes sense to promote leveraging it across platforms, for the benefit of developers and their end users, humans, cats, dogs, monkeys, you name it.
Feel free to tell your stories enabled by this project in GitHub discussions, or to tell me about them on Twitter DM, Kotlin's Slack or email, I'll be happy to know about it! 😊
The code: Louis CAD, pair-programming with Waqas Ahmed, remotely, using pop.com
Pair-programming:
- Waqas Ahmed, Germany
Pre-release testing, and screenshots:
- Rachid Insa, Ghana (Windows 10, 8GB of RAM, 5400rpm HDD 😬, xMbps connection 😬)
- Jean-Michel Fayard, France (Chrome OS [Debian], 4GB of RAM 😬)
- Romain Bouchaud, France (Windows 10)
We hope you do!
If you want to support this project, and future Kotlin related projects from Louis CAD and friends, here are 3 things you can do:
- Star this project 🙏
- Say thanks on Twitter and spread the word 😊📢
- Get your company, or yourself, to help me get past 50 monthly sponsors ❤️💜
- Linux x64 (arm64 not tested yet, might not work, please open an issue if you use it)
- Windows x64
- macOS
With IntelliJ IDEA (including the Community Edition), you can create a Kotlin Mobile app or library project.
You can later on open it in Android Studio, to get the latest and greatest on the Android side, while still sharing code and writing iOS specific code comfortably.
You need use the required host OS for compilation when you need to compile, but you don't need it when writing the code.
That required OS can run in a VM (Virtual Machine), on a shared machine of your team or from a trustworthy friend, or on machine in "the cloud", be it a CI (Continuous Integration) service, or an infrastructure service.
If you had a particularly great experience with a CI service for native apps developers, feel free to let me know and tell me how your experience was great. I'll consider adding the name here.
We're quite confident about its reliability.
We tested it on multiple 1.4 and 1.5 Kotlin releases and pre-releases, but had to give up exhaustiveness to save time, bandwidth. So far, we tested it on macOS, Windows and Chrome OS (essentially Linux), with zero issue, apart that some people tolerate very slow computers! Well, I used to do as well…
Almost guaranteed to never happen.
Kotlin is developed in the open, and folks at JetBrains that maintain and improve Kotlin would not want to make Kotlin less complete!
If there's any change arriving into Kotlin that would affect this plugin, or that, who knows, would enable CompleteKotlin to be even more complete, if it's possible, I'm going to be aware, and I'll address it and release a new version, most likely ahead of time, so you should never have to choose between upgrading Kotlin and keeping Kotlin complete.
You can start exploring the code in IntelliJ IDEA starting from the CompleteKotlin.kt file, at the time of writing this, it's less than 1000 Kotlin lines overall.
In a nutshell, it downloads files that contain platform klibs intended for other OSes, and puts them in the right directories. It only downloads the missing ones, so it will have no effect on macOS if you don't use Windows (aka. mingw) or Linux MIPS targets for example.
These platform klibs notably contain all platform APIs as Kotlin symbols that the IDE will recognize.
Yes, just reach out via Twitter DM, Kotlin Slack or something, we'll work it out.
MIT
No usage restrictions or liabilities, but please, be a responsible and nice human being, even when thinking and writing code 😉
Unless it's designed to avoid true abuse, it's often a bad idea, at least, bad outcomes overall IMHO.
Yes
Yes
Yes
Hum… yes. Also, WSL2 is quite cool for developers IMHO.
🔮 looks like I might…
Depends. I like kiwis and pears too to name a few.
Yes, I think the FAQ is quite complete now. 🥁
However, if there's any question you want to see here, feel free to ask in the GitHub Discussions of this project.