Termux #1278
Replies: 2 comments 13 replies
-
|
Interesting! May I ask what is the motivation for wanting to run VSCode directly on the Android device?
One of my goals is to make CodeLLDB as portable as practically possible across various Linux distros and their versions. So I'm linking everything statically, except for the required and very common shared libraries. To ensure that nothing else creeps in, the test suite validates that CodeLLDB has only whitelisted runtime dependencies. |
Beta Was this translation helpful? Give feedback.
-
The reason is because I believe that the most popular consumer operating system in the world, Android, has the ability to run almost all of the same development tools, productivity tools, server software and software in general that GNU/Linux, Alpine Linux and FreeBSD are already known for, but in an extremely portable and convenient form factor that can be used anywhere without the need for a full laptop computer, at full performance without the need for resource-intensive steps like installing a completely separate operating system in a dual boot, VM, or container, and I want to make as many guides, tools and packages as possible to help everyone else who also needs to run software on Android that was written for GNU/Linux, Alpine Linux or FreeBSD, and in doing so, I believe that I can help make the lives of economically disadvantaged people around the world better by making it easier for them to access and participate in the global software development and software productivity ecosystem even if they only have an Android device and not a standard laptop or desktop computer.
I see, I hadn't yet run the test suite but now I have, and it does appear that if I want the test suite to pass in the build I set up here, I will need to locally modify some of the tests and make sure that both the I can see that something about the tests is accurately identifying the presence of Android and Termux system library dependencies in the resulting build, which is expected to happen since they are slightly different from those of GNU/Linux (as are those of Alpine Linux), but the changes I have made so far aren't sufficient to allow the tests to pass yet. Typically, in Android, it is standard for On the other hand, it might not be a super high priority to make all of the tests that were intended for GNU/Linux work by manually changing the tests, it would just be an unimportant exercise in completeness of this custom build of codelldb, because I understand completely that this target is out of scope for the goals of the upstream project. For comparison, I can see that the Alpine Linux version here, #391 (comment), around which some discussion very similar to some of the things I have talked about here has already taken place (but from the Alpine Linux perspective rather than the Android perspective), does not appear to make any attempt to pass the testsuite. In general, I am aware that this kind of "alternative UNIX-like OS target" is not really a priority for the upstream of most projects, which is completely understandable - I can see similar discussions regarding FreeBSD support in the issues and PRs, in which it is explained that FreeBSD support is also out of scope for the upstream project, partly due to the lack of an easy way to build in CI. This is the reason why I decided to post these steps in the discussions page rather than in an issue or a PR. In the Termux project, many packages are being built, patched, and deployed in a CI system that is set up to be entirely suitable for Android (we are essentially using a specialized variant format of |
Beta Was this translation helpful? Give feedback.
-
|
For your final step I found that linking the binary didn't work. Had better luck creating an So the commands would be:
cd ~/.vscode-oss/extensions/vadimcn.vscode-lldb-*/
mv lldb lldb-bin
mkdir -p lldb/lib
ln -sf /data/data/com.termux/files/usr/lib/liblldb.so lldb/lib/liblldb.soI don't personally care about vscode either since I'm using it with nvim but I'm afraid I have no idea which steps, if any are unnecessary and if I can do any significant cleanup after these steps to reduce the storage footprint. Would appreciate any advice. For any other lost soul on their termux nvim debugger journey I went with nvchad and made a % cat .config/nvim/lua/plugins/dap.lua
return {
{ "julianolf/nvim-dap-lldb",
dependencies = { "mfussenegger/nvim-dap" }, },
{ "mfussenegger/nvim-dap",
dependencies = { "leoluz/nvim-dap-go",
"rcarriga/nvim-dap-ui", "nvim-neotest/nvim-nio",
"williamboman/mason.nvim",
}, config = function() local dap = require "dap"
local ui = require "dapui"
require("dapui").setup()
require("dap-go").setup() dap.adapters.lldb = {
type = "executable", command = "/data/data/com.termux/files/home/.vscode-oss/extensions/vadimcn.vscode-lldb-1.11.4-dev.2508092032/adapter/codelldb", name = "lldb"
}
dap.configurations.cpp = {
{
name = "Launch C++ file",
type = "lldb",
request = "launch",
program = function()
return vim.fn.input("Path to executable: ", vim.fn.getcwd() .. "/", "file")
end,
cwd = "${workspaceFolder}",
stopOnEntry = false,
args = {},
runInTerminal = false,
}
}
-- More setup here
}
} |
Beta Was this translation helpful? Give feedback.
-
I'm not sure if I replied to this or not before but it did work with simply Edit: Well, figured I'd try the command Get:1 https://mirror.sjtu.edu.cn/termux/termux-x11 x11/main aarch64 codelldb aarch64 1.11.5-1 [1096 kB]
Fetched 1096 kB in 4s (290 kB/s)
Selecting previously unselected package codelldbWorked just fine through termux-x11, thanks! |
Beta Was this translation helpful? Give feedback.
-
|
Great! As of a couple of days ago, pkg upgrade
pkg install x11-repo
pkg install codelldbFrom now on, you should be able to get updates or install codelldb on any Android device by using only those commands, without having to manually browse to anything, for at least as long as I continue to patch and compile the updates for codelldb to run entirely on Android with only one device (since I am currently the only person who is making code which makes codelldb run entirely on Android, if I stop then you would stop receiving updates if codelldb upstream releases a new version for GNU/Linux, but I'll try not to stop) |
Beta Was this translation helpful? Give feedback.
-
Yes, you will need to use The reason why it is necessary to install the In this case, the package that I compiled from the same source code as the There are a few viable workarounds for that problem, which some packages do use to allow themselves to be installed without first using Do you think you are OK with the |
Beta Was this translation helpful? Give feedback.
-
|
I am totally ok with doing |
Beta Was this translation helpful? Give feedback.
-
On this note, I likely won't be too bothered over not having latest upstream, since if dap ui breaks I'll fetch an earlier version of it and keep that synced with codelldb. If I do need the latest for a proper release build I can always ssh into a full linux machine. But this gives me major convenience |
Beta Was this translation helpful? Give feedback.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
-
Important
This is now upstreamed to Termux, making manual building no longer necessary.
You can get the precompiled build with these commands:
A slightly more in-depth guide for
code-serveris now here:Termux is a complete Terminal Emulator Application and distribution of
bash,apt,nodejs,cargo,rustc,clang,lldb,make,cmake, X11 Server andcode-ossfor Android.With Termux, cross-compilation becomes optional, instead of required, for writing, building, and debugging C, C++, and Rust on Android.
Unlike the situation near the beginning of Android's lifecycle (2010-2015), a second device other than Android is no longer necessarily required.
I am going to write the full steps that I used to successfully compile, install and use codelldb entirely inside of Termux, which is to say, to use codelldb on Android with cross-compilation entirely disabled, as opposed to the standard Android development workflow which normally requires the use of cross-compilation at some point.
Unfortunately, the steps are a little bit messy, and I am not completely sure yet if all of these steps and patches are absolutely required or if some of them can be removed or refactored to streamline the installation process in a better way, but this is what is initially working for me so I wanted to share this.
Install Dependencies
Note
pkg install tur-repoto getcode-ossmight not be required in the future eventually after this series of events has concluded:Retrieve Code
Note
Last designed and tested for codelldb commit 8aa3be2
Apply Patch
Note
I created this patch onto codelldb to implement Android support.
I am not sure about this part:
AllowedDependencies. I do not understand what that is for, so the list of things I typed there is just guessing.Fetch Cargo Crates and
sed-patchweaklinkNote
This Cargo Crate, https://github.com/vadimcn/weaklink, was designed only for GNU/Linux, and must be patched in the "treat Android as Linux" style in order to avoid build errors.
Set Environment Variables
Note
These environment variables helped me bypass errors during the build process
Configure and Build
Note
The codelldb documentation states "You will get linker errors if you don't use the toolchain file", but for some reason, it seems to still work for me even though I didn't technically use
-DCMAKE_TOOLCHAIN_FILE. I am not sure exactly why.Install
.vsixNote
For some reason, the
lldbbinary does not get placed in the necessary location automatically after--install-extension, so I use another command to create a symbolic link to the original location, which appears to work.Done
Note
After the above steps,
code-ossshows that codelldb is installed for me, and it begins working in the "run and debug" menu exactly the same as it works on VSCodium on GNU/Linux! Here is an example of how to launchcode-ossin the Termux:X11 app, but I suspect that other editors that do not necessarily require X11, likecode-serverfrompkg install code-server, might also work with it!Beta Was this translation helpful? Give feedback.
All reactions