init

components/android/CMakeLists.txt

@@ -0,0 +1,35 @@
+# Copyright (c) 2023, Thomas Atkinson
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 the "License";
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+vkb__register_component(
+    NAME android_platform
+    HEADERS
+        include/android/context.hpp
+    SRC
+        src/context.cpp
+        src/entrypoint.cpp
+    LINK_LIBS
+        vkb__core
+)
+
+add_definitions(-DVULKAN_HPP_TYPESAFE_CONVERSION=1)
+
+# Import game-activity static lib inside the game-activity_static prefab module.
+find_package(game-activity REQUIRED CONFIG)
+target_link_libraries(vkb__android_platform PUBLIC log android game-activity::game-activity_static)
+
+# attach to core
+target_link_libraries(vkb__core INTERFACE vkb__android_platform)

components/android/include/android/context.hpp

@@ -0,0 +1,46 @@
+/* Copyright (c) 2023, Thomas Atkinson
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed under the Apache License, Version 2.0 the "License";
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#pragma once
+
+#include <string>
+#include <vector>
+
+#include <core/platform/context.hpp>
+
+#include <game-activity/native_app_glue/android_native_app_glue.h>
+
+namespace vkb
+{
+/**
+ * @brief Android platform context
+ *
+ * @warning Use in extreme circumstances with code guarded by the PLATFORM__ANDROID define
+ */
+class AndroidPlatformContext final : public PlatformContext
+{
+  public:
+	AndroidPlatformContext(android_app *app);
+	~AndroidPlatformContext() override = default;
+
+	android_app *app{nullptr};
+
+	static std::string              android_external_storage_directory;
+	static std::string              android_temp_directory;
+	static std::vector<std::string> android_arguments;
+};
+}        // namespace vkb

components/android/src/context.cpp

@@ -0,0 +1,85 @@
+/* Copyright (c) 2023-2024, Thomas Atkinson
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed under the Apache License, Version 2.0 the "License";
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include "android/context.hpp"
+
+#include <jni.h>
+
+extern "C"
+{
+	// TODO: Arguments can be parsed from the bundle
+	JNIEXPORT void JNICALL
+	    Java_com_khronos_vulkan_1samples_SampleLauncherActivity_sendArgumentsToPlatform(JNIEnv *env, jobject thiz, jobjectArray arg_strings)
+	{
+		std::vector<std::string> args;
+
+		for (int i = 0; i < env->GetArrayLength(arg_strings); i++)
+		{
+			jstring arg_string = (jstring) (env->GetObjectArrayElement(arg_strings, i));
+
+			const char *arg = env->GetStringUTFChars(arg_string, 0);
+
+			args.push_back(std::string(arg));
+
+			env->ReleaseStringUTFChars(arg_string, arg);
+		}
+
+		vkb::AndroidPlatformContext::android_arguments = args;
+	}
+}
+
+namespace details
+{
+std::string get_external_storage_directory(android_app *app)
+{
+	return app->activity->externalDataPath;
+}
+
+std::string get_external_cache_directory(android_app *app)
+{
+	JNIEnv *env;
+	app->activity->vm->AttachCurrentThread(&env, NULL);
+
+	jclass    cls         = env->FindClass("android/app/NativeActivity");
+	jmethodID getCacheDir = env->GetMethodID(cls, "getCacheDir", "()Ljava/io/File;");
+	jobject   cache_dir   = env->CallObjectMethod(app->activity->javaGameActivity, getCacheDir);
+
+	jclass    fcls        = env->FindClass("java/io/File");
+	jmethodID getPath     = env->GetMethodID(fcls, "getPath", "()Ljava/lang/String;");
+	jstring   path_string = (jstring) env->CallObjectMethod(cache_dir, getPath);
+
+	const char *path_chars = env->GetStringUTFChars(path_string, NULL);
+	std::string temp_folder(path_chars);
+
+	env->ReleaseStringUTFChars(path_string, path_chars);
+	app->activity->vm->DetachCurrentThread();
+	return temp_folder;
+}
+}        // namespace details
+
+namespace vkb
+{
+std::vector<std::string> AndroidPlatformContext::android_arguments = {};
+
+AndroidPlatformContext::AndroidPlatformContext(android_app *app) :
+    PlatformContext{}, app{app}
+{
+	_external_storage_directory = details::get_external_storage_directory(app);
+	_temp_directory             = details::get_external_cache_directory(app);
+	_arguments                  = android_arguments;
+}
+}        // namespace vkb

components/android/src/entrypoint.cpp

@@ -0,0 +1,25 @@
+/* Copyright (c) 2023, Thomas Atkinson
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed under the Apache License, Version 2.0 the "License";
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include <core/platform/entrypoint.hpp>
+
+#include "android/context.hpp"
+
+std::unique_ptr<vkb::PlatformContext> create_platform_context(android_app *app)
+{
+	return std::make_unique<vkb::AndroidPlatformContext>(app);
+}