{"id":22625093,"url":"https://github.com/gnustep/tools-android","last_synced_at":"2026-03-01T07:13:48.191Z","repository":{"id":56046196,"uuid":"172683950","full_name":"gnustep/tools-android","owner":"gnustep","description":"Objective-C on Android with Foundation, CoreFoundation, and libdispatch.","archived":false,"fork":false,"pushed_at":"2025-11-18T09:09:56.000Z","size":277,"stargazers_count":49,"open_issues_count":1,"forks_count":13,"subscribers_count":9,"default_branch":"master","last_synced_at":"2026-01-05T23:57:49.735Z","etag":null,"topics":["android","corefoundation","foundation","gnustep","libdispatch","objective-c","objective-c-plus-plus"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gnustep.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-02-26T09:51:49.000Z","updated_at":"2025-12-11T12:25:01.000Z","dependencies_parsed_at":"2024-08-23T12:57:38.297Z","dependency_job_id":"07da334b-9ccf-4022-99fe-9f919532b188","html_url":"https://github.com/gnustep/tools-android","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/gnustep/tools-android","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnustep%2Ftools-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnustep%2Ftools-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnustep%2Ftools-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnustep%2Ftools-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gnustep","download_url":"https://codeload.github.com/gnustep/tools-android/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnustep%2Ftools-android/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29963125,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T06:55:38.174Z","status":"ssl_error","status_checked_at":"2026-03-01T06:53:04.810Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","corefoundation","foundation","gnustep","libdispatch","objective-c","objective-c-plus-plus"],"created_at":"2024-12-09T00:19:20.520Z","updated_at":"2026-03-01T07:13:48.127Z","avatar_url":"https://github.com/gnustep.png","language":"Shell","readme":"GNUstep Android Toolchain\n=========================\n\n[![CI](https://github.com/gnustep/tools-android/actions/workflows/ci.yml/badge.svg)](https://github.com/gnustep/tools-android/actions/workflows/ci.yml?query=branch%3Amaster)\n\nThis project comprises a collection of scripts to build a GNUstep toolchain for Android. The toolchain can then be used in an Android project to compile and run Objective-C code using the Foundation and CoreFoundation libraries.\n\nThe toolchain is built using the Android NDK (installed e.g. via [Android Studio](https://developer.android.com/studio)), and is set up to target Android API level 24 (7.0 / Nougat) and all available Android ABIs (armeabi-v7a, arm64-v8a, x86, x86_64).\n\n\nLibraries\n---------\n\nThe toolchain consists of the following libraries:\n\n* [GNUstep Base Library](https://github.com/gnustep/libs-base) (Foundation)\n* [GNUstep CoreBase Library](https://github.com/gnustep/libs-corebase) (CoreFoundation)\n* [libobjc2](https://github.com/gnustep/libobjc2) (using gnustep-2.0 runtime)\n* [libdispatch](https://github.com/apple/swift-corelibs-libdispatch) (official Apple release from the Swift Core Libraries)\n* [libffi](https://github.com/libffi/libffi)\n* [libiconv](https://www.gnu.org/software/libiconv/)\n* [libxml2](https://github.com/GNOME/libxml2)\n* [libxslt](https://github.com/GNOME/libxslt)\n* [libcurl](https://github.com/curl/curl)\n* [OpenSSL](https://github.com/KDAB/android_openssl)\n* [ICU](https://github.com/unicode-org/icu)\n\n\nRequirements\n------------\n\nSupported host platforms are macOS and Linux.\n\nThe toolchain requires the Android NDK, which can be installed via [Android Studio](https://developer.android.com/studio)’s SDK Manager. The NDK installation will be located using the `ANDROID_NDK_ROOT` environment variable if set, or otherwise it will use the latest version in `~/Library/Android/sdk/ndk` (macOS) / `~/Android/sdk/ndk` (Linux). A different NDK path can also be provided using the `--ndk` flag when building the toolchain (see below).\n\nPlease note that NDK r21 or later is required, as earlier NDK releases contain Clang versions with bugs which prevent usage of the gnustep-2.0 Objective-C runtime.\n\n\nInstallation\n------------\n\nTo install a pre-built release, download it from [the releases on GitHub](https://github.com/gnustep/tools-android/releases) and unpack the \"GNUstep\" folder into the following location depending on your OS (`$GNUSTEP_HOME`):\n\n* macOS: `~/Library/Android/GNUstep`\n* Linux: `~/Android/GNUstep`\n\n\nUsing the Toolchain\n-------------------\n\nThe [android-examples](https://github.com/gnustep/android-examples) repository contains Android Studio and Qt example projects using this project that can be used as templates for integrating Objective-C code into new or existing Android projects.\n\nTo use the toolchain from an Android project, you can use `$GNUSTEP_HOME/$ABI_NAME/bin/gnustep-config` to obtain various flags that should be used to compile and link Objective-C files, e.g.:\n\n* `gnustep-config --variable=CC`\n* `gnustep-config --objc-flags` (or `--debug-flags`)\n* `gnustep-config --base-libs`\n\nCall `gnustep-config --help` to obtain the full list of available variables.\n\n\nStatus and Known Issues\n-----------------------\n\nThe toolchain is being used in production in an award-winnning music app available on Google Play.\n\nFollowing are some notes and known issues about using GNUstep on Android.\n\n* GNUstep base currently has no native integration between the Android run-loop and NSRunLoop or the libdispatch main queue, so things like `-performSelector:withObject:afterDelay:` or dispatching on `dispatch_get_main_queue()` will not work out of the box. An integration depends on the setup of the app (e.g. whether using Android Studio, Qt, or something else), and is possible to add in the app by swizzing NSRunLoop. Feel free to open an issue if this is of interest to you and you would like more information.\n* GNUstep Base is integrated with Android’s [app-specific storage](https://developer.android.com/training/data-storage) and uses the path returned by `Context.getFilesDir()` as `NSHomeDirectory()` and when querying for directory paths (`NSLibraryDirectory`, `NSApplicationSupportDirectory`, etc.). It also uses `Context.getCacheDir()` as `NSTemporaryDirectory` and `NSCachesDirectory` (with `NSUserDomainMask`).\n* GNUstep Base is further integrated with the [Android asset manager](https://developer.android.com/reference/android/content/res/AssetManager), and supports accessing the app’s resources from `[NSBundle mainBundle]` via APIs such as `-pathForResource:ofType:` and `-URLForResource:ofType:`, and reading them using NSFileManager, NSFileHandle, and NSDirectoryEnumerator APIs. This is done by returning paths from NSBundle APIs with a fixed, fake, per-app prefix (`Context.getPackageCodePath()` without extension + `/Resources`), which internally get routed through the NDK’s [AAsset](https://developer.android.com/ndk/reference/group/asset) API for reading.\n* Note that NSDirectoryEnumerator is not able to enumerate directories in the app’s main bundle due to a [limitation](https://issuetracker.google.com/issues/140538113) of the AAssetDir API.\n* The app must call `GSInitializeProcessAndroid()` (defined in `NSProcessInfo.h`) on launch in order to initialize the above Android-specific functionality in GNUstep.\n* GNUstep Base doesn’t currently get the system languages on Android, which combined with the inability to list directories in the main bundle (see above) means that `NSLocalizedString()` won’t work out of the box even if localized strings are present in the app’s assets. As a workaround, the app should manually call `-[NSUserDefaults setUserLanguages:]` with a list of supported locales ordered by the user’s system language preferences.\n* GNUstep Base will also currently not return the system locale as the current `NSLocale` on Android (the current locale will always default to `en_US_POSIX`). As a workaround, the app can manually set the system’s locale identifier for the key `\"Locale\"` in NSUserDefaults, and use `-[NSLocale autoupdatingCurrentLocale]` to retreive the locale.\n* Android will not output stdout or stderr to logcat by default, which might cause some log or error output from GNUstep or other libraries to be missing. You can run a thread in your app to write these streams to the Android log to work around this, which is recommended for debugging.\n\nFor the last three points above please refer to [GSInitialize.m](https://github.com/gnustep/android-examples/blob/master/hello-objectivec/app/src/main/cpp/GSInitialize.m) in the examples for details.\n\n\nPrerequisites for Building\n--------------------------\n\nThe following packages are required for building the toolchain.\n\n**macOS**\n\nInstall required packages via [Homebrew](https://brew.sh):\n\n```\nbrew install git-lfs cmake autoconf automake libtool pkg-config\ngit lfs install\n```\n\n**Linux**\n\nInstall required packages via APT:\n\n```\nsudo apt install git git-lfs curl cmake make autoconf libtool pkg-config texinfo python3-distutils\ngit lfs install\n```\n\nPlease note that you need to have CMake version 3.15.1 or later ([for libdispatch](https://github.com/apple/swift-corelibs-libdispatch/blob/master/CMakeLists.txt#L2)).\n\n\nBuilding the Toolchain\n----------------------\n\nRun the [build.sh](build.sh) script to build the toolchain yourself:\n\n```\nUsage: ./build.sh\n  --prefix INSTALL_ROOT      Install toolchain into given directory (default: see below)\n  --dist-root DIST_ROOT      Make toolchain relocatable to given path relative to home folder on other machines\n                             (use \"HOME\" as placeholder for home folder, e.g. \"HOME/Library/Android/GNUstep\")\n  -n, --ndk NDK_PATH         Path to existing Android NDK (default: ANDROID_NDK_ROOT)\n  -a, --abis ABI_NAMES       ABIs being targeted (default: \"armeabi-v7a arm64-v8a x86 x86_64\")\n  -l, --level API_LEVEL      Android API level being targeted (default: 23)\n  -b, --build BUILD_TYPE     Build type \"Debug\" or \"Release\" or \"RelWithDebInfo\" (default: RelWithDebInfo)\n  -u, --no-update            Don't update projects to latest version from GitHub\n  -c, --no-clean             Don't clean projects during build (e.g. for building local changes, only applies to first ABI being built)\n  -p, --patches DIR          Apply additional patches from given directory\n  -o, --only PHASE           Build only the given phase (e.g. \"gnustep-base\", requires previous build)\n  -h, --help                 Print usage information and exit\n```\n\nThe toolchain builds and installs the GNUstep toolchain into the following location (`$GNUSTEP_HOME`):\n\n* macOS: `~/Library/Android/GNUstep`\n* Linux: `~/Android/GNUstep`\n\nThe build for each supported ABI is installed into its separate subfolder at that location (both libraries and header files differ per ABI).\n\n\nAcknowledgements\n----------------\n\nBased on original work by Ivan Vučica.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnustep%2Ftools-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgnustep%2Ftools-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnustep%2Ftools-android/lists"}