1 files changed, 70 insertions, 0 deletions

diff --git a/src/android.h b/src/android.h
new file mode 100644
index 00000000000..6bdcd38ed68
--- /dev/null
+++ b/src/android.h
@@ -0,0 +1,70 @@
+/* Android initialization for GNU Emacs.
+
+Copyright (C) 2023 Free Software Foundation, Inc.
+
+This file is part of GNU Emacs.
+
+GNU Emacs is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or (at
+your option) any later version.
+
+GNU Emacs is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.  */
+
+/* On Android, Emacs is built as a shared library loaded from Java
+   using the Java Native Interface.  Emacs's `main' function is
+   renamed `android_emacs_init', and runs with some modifications
+   inside a separate thread, communicating with the Java code through
+   a table of function pointers.  */
+
+#ifndef _ANDROID_H_
+#ifndef ANDROID_STUBIFY
+#include <jni.h>
+#include <pwd.h>
+#include <sys/stat.h>
+#endif
+
+/* This must be used in every symbol declaration to export it to the
+   JNI Emacs wrapper.  */
+#define ANDROID_EXPORT __attribute__ ((visibility ("default")))
+
+extern bool ANDROID_EXPORT android_init_gui;
+extern int ANDROID_EXPORT android_emacs_init (int, char **);
+
+#ifndef ANDROID_STUBIFY
+
+extern int android_select (int, fd_set *, fd_set *, fd_set *,
+                           struct timespec *, const sigset_t *);
+
+extern bool android_file_access_p (const char *, int);
+extern int android_open (const char *, int, int);
+extern char *android_user_full_name (struct passwd *);
+extern int android_fstat (int, struct stat *);
+extern int android_fstatat (int, const char *restrict,
+                            struct stat *restrict, int);
+extern int android_close (int);
+
+#endif
+
+/* JNI functions should not be built when Emacs is stubbed out for the
+   build.  These should be documented in EmacsNative.java.  */
+
+#ifndef ANDROID_STUBIFY
+#include <jni.h>
+
+extern JNIEnv *android_java_env;
+
+#define ANDROID_DELETE_LOCAL_REF(ref)                           \
+  ((*android_java_env)->DeleteLocalRef (android_java_env,       \
+                                        (ref)))
+
+#define NATIVE_NAME(name) Java_org_gnu_emacs_EmacsNative_##name
+
+#endif
+#endif /* _ANDROID_H_ */