Android support

.ci/android.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+cd examples
+../pmbuild android -libs
+../pmbuild android
+cd build/android
+gradle wrapper
+./gradlew assembleRelease

.github/workflows/build.yaml

@@ -88,7 +88,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
-        with: 
+        with:
           submodules: "recursive"
           lfs: true
       - run: |
@@ -98,3 +98,23 @@ jobs:
           ../pmbuild linux-editor -libs
           ../pmbuild linux-editor
           ../pmbuild make linux-editor all
+  android:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          submodules: "recursive"
+          lfs: true
+      - uses: actions/setup-java@v4
+        with:
+          distribution: "temurin"
+          java-version: "21"
+      - uses: gradle/actions/setup-gradle@v3
+        with:
+          gradle-version: 8.14.3
+      - run: |
+          cd examples
+          ../pmbuild android
+          cd build/android
+          gradle wrapper
+          ./gradlew assembleRelease

core/pen/include/console.h

@@ -63,7 +63,12 @@ inline void output_debug(const c8* format, ...)
 #else
 #define PEN_SYSTEM system
 #endif
+#ifdef PEN_PLATFORM_ANDROID
+    #include <android/log.h>
+    #define PEN_LOG(F, ...) __android_log_print(ANDROID_LOG_DEBUG, "PMTECH", F,  ## __VA_ARGS__)
+#else
 #define PEN_LOG output_debug
+#endif
 #define PEN_LOG_VA(fmt, va) output_debug_va(fmt, va)
 #define PEN_ASSERT assert
 #define PEN_ASSERT_MSG(A, M)                                                                                                 \

core/pen/include/file_system.h

@@ -28,6 +28,7 @@ namespace pen
 
     bool       filesystem_file_exists(const c8* filename);
     pen_error  filesystem_read_file_to_buffer(const c8* filename, void** p_buffer, u32& buffer_size);
+    pen_error  filesystem_read_file_to_buffer_direct(const c8* filename, void** p_buffer, u32& buffer_size);
     pen_error  filesystem_getmtime(const c8* filename, u32& mtime_out);
     size_t     filesystem_getsize(const c8* filename);
     void       filesystem_toggle_hidden_files();

core/pen/include/os.h

@@ -57,6 +57,10 @@ namespace pen
     bool             os_is_backgrounded();
     void             os_register_background_callback(void (*callback)(bool));
     bool             os_require_audio_reinit(bool reset);
+    Str              os_get_clipboard_string();
+    void             os_clear_clipboard_string();
+    void             os_enable_paste_popup(bool enable);
+    bool             os_tapped();
 
     // music
     struct music_item

core/pen/project.lua

@@ -4,7 +4,7 @@ local function setup_win32()
         {
             "$(VK_SDK_PATH)/Include"
         }
-    elseif renderer_dir == "opengl" then         
+    elseif renderer_dir == "opengl" then
         includedirs
         {
             "../../third_party/glew/include",
@@ -16,31 +16,31 @@ local function setup_win32()
 end
 
 local function setup_ios()
-    files 
-    {  
+    files
+    {
         "source/posix/**.cpp",
         "source/mach/**.cpp"
     }
 end
 
 local function setup_osx()
-    files 
-    {  
+    files
+    {
         "source/posix/**.cpp",
         "source/mach/**.cpp"
     }
 end
 
 local function setup_linux()
-    files 
-    {  
+    files
+    {
         "source/posix/**.cpp"
     }
 end
 
 local function setup_web()
-    files 
-    {  
+    files
+    {
         "source/posix/**.cpp",
         "source/linux/timer.cpp",
         "source/single_threaded/**.cpp"
@@ -52,9 +52,12 @@ local function setup_web()
 end
 
 local function setup_android()
-    files 
-    {  
-        "source/posix/**.cpp"
+    files
+    {
+        "source/posix/pen_string.cpp",
+        "source/posix/threads.cpp",
+
+        "source/linux/timer.cpp",
     }
 end
 
@@ -74,58 +77,58 @@ local function setup_platform()
     end
 end
 
--- Project    
+-- Project
 project "pen"
     setup_env()
     setup_platform_defines()
-    setup_platform() 
-    location ("build/" .. platform_dir)
+    setup_platform()
     kind "StaticLib"
+    location ("build/" .. platform_dir)
     language "C++"
-    
-    files 
+
+    files
     {
         "include/*.h",
         "source/*.cpp",
-     
-        "include/" .. platform_dir .. "/**.h", 
+
+        "include/" .. platform_dir .. "/**.h",
 
         "source/" .. platform_dir .. "/**.cpp",
         "source/" .. platform_dir .. "/**.mm",
-    
-        "../../third_party/str/*.cpp", 
+
+        "../../third_party/str/*.cpp",
     }
-    
-    includedirs 
+
+    includedirs
     {
         "include",
-        "include/" .. platform_dir, 
-    
-        "../../third_party", 
+        "include/" .. platform_dir,
+
+        "../../third_party",
         "../../third_party/libstem_gamepad/source"
     }
-    
+
     -- rendere selection, and allow for no renderer
     if string.len(renderer_dir) > 0 then
 		files
-		{   
+		{
 			"include/" .. renderer_dir .. "/**.h",
 			"source/" .. renderer_dir .. "/**.cpp",
 			"source/" .. renderer_dir .. "/**.mm",
 		}
-		includedirs 
+		includedirs
 		{
 			"include/" .. renderer_dir,
 		}
     end
-            
+
     filter "configurations:Release"
         defines { "NDEBUG" }
         entrypoint "WinMainCRTStartup"
         optimize "Speed"
         targetdir ("lib/" .. platform_dir .. "/release")
         targetname "pen"
-        
+
     filter "configurations:Debug"
         defines { "DEBUG" }
         entrypoint "WinMainCRTStartup"

core/pen/source/android/file_system.cpp

@@ -0,0 +1,151 @@
+// file_system.cpp
+// Copyright 2014 - 2025 Alex Dixon.
+// License: https://github.com/polymonster/pmtech/blob/master/license.md
+
+#include "file_system.h"
+#include "memory.h"
+#include "os.h"
+#include "pen.h"
+#include "pen_string.h"
+
+#include <sys/stat.h>
+#include <dirent.h>
+
+namespace pen
+{
+    pen_error filesystem_enum_volumes(fs_tree_node& results)
+    {
+        // stub
+        return PEN_ERR_OK;
+    }
+
+    void filesystem_toggle_hidden_files()
+    {
+        // stub
+    }
+
+    bool match_file(struct dirent* ent, s32 num_wildcards, va_list wildcards)
+    {
+        return false;
+    }
+
+    pen_error filesystem_enum_directory(const c8* directory, fs_tree_node& results, s32 num_wildcards, ...)
+    {
+        va_list wc;
+        va_start(wc, num_wildcards);
+
+        pen_error res = filesystem_enum_directory(directory, results, num_wildcards, wc);
+
+        va_end(wc);
+
+        return res;
+    }
+
+    pen_error filesystem_enum_directory(const c8* directory, fs_tree_node& results, s32 num_wildcards, va_list wildcards)
+    {
+        DIR*           dir;
+        struct dirent* ent;
+
+        u32 num_items = 0;
+        if ((dir = opendir(directory)) != nullptr)
+        {
+            while ((ent = readdir(dir)) != nullptr)
+            {
+                if (match_file(ent, num_wildcards, wildcards))
+                {
+                    num_items++;
+                }
+            }
+
+            closedir(dir);
+        }
+
+        if (num_items == 0)
+        {
+            return PEN_ERR_FILE_NOT_FOUND;
+        }
+
+        if (results.children == nullptr)
+        {
+            // alloc new mem
+            results.children = (fs_tree_node*)pen::memory_alloc(sizeof(fs_tree_node) * num_items);
+            pen::memory_zero(results.children, sizeof(fs_tree_node) * num_items);
+        }
+        else
+        {
+            // grow buffer
+            if (results.num_children < num_items)
+            {
+                results.children = (fs_tree_node*)pen::memory_realloc(results.children, sizeof(fs_tree_node) * num_items);
+            }
+        }
+
+        results.num_children = num_items;
+
+        u32 i = 0;
+        if ((dir = opendir(directory)) != nullptr)
+        {
+            while ((ent = readdir(dir)) != nullptr)
+            {
+                if (match_file(ent, num_wildcards, wildcards))
+                {
+                    if (results.children[i].name == nullptr)
+                    {
+                        // allocate 1024 file buffer
+                        results.children[i].name = (c8*)pen::memory_alloc(1024);
+                        pen::memory_zero(results.children[i].name, 1024);
+                    }
+
+                    u32 len = pen::string_length(ent->d_name);
+                    len = min<u32>(len, 1022);
+
+                    memcpy(results.children[i].name, ent->d_name, len);
+                    results.children[i].name[len] = '\0';
+
+                    results.children[i].num_children = 0;
+
+                    ++i;
+                }
+            }
+
+            closedir(dir);
+        }
+
+        return PEN_ERR_OK;
+    }
+
+    pen_error filesystem_enum_free_mem(fs_tree_node& tree)
+    {
+        for (s32 i = 0; i < tree.num_children; ++i)
+        {
+            filesystem_enum_free_mem(tree.children[i]);
+        }
+
+        pen::memory_free(tree.children);
+        pen::memory_free(tree.name);
+
+        return PEN_ERR_OK;
+    }
+
+    pen_error filesystem_getmtime(const c8* filename, u32& mtime_out)
+    {
+        struct stat st;
+        if (stat(filename, &st) == 0) {
+            mtime_out = (u32)st.st_mtime; // modification time
+            return PEN_ERR_OK;
+        }
+
+        return PEN_ERR_FILE_NOT_FOUND;
+    }
+
+    const c8** filesystem_get_user_directory(s32& directory_depth)
+    {
+        return nullptr;
+    }
+
+    s32 filesystem_exclude_slash_depth()
+    {
+        // directory depth 0 can be a slash
+        return 0;
+    }
+} // namespace pen