如何将stockfish 集成到Android 应用程序中？

Question

我正在尝试研究如何将 stockfish（或任何与 UCI 兼容的引擎）集成到我的 Android 应用程序中。

我从这里下载了 stockfish Android zip： Download Stockfish Engine.

zip的Android目录下有两个文件：

• stockfish-8-arm64-v8a
• stockfish-8-armeabi-v7a

我有两个问题：

1. 我是否只需将这两个文件包含到我的应用程序中（如果需要，我应该将它们放在哪里）？我希望这些是预先构建的二进制文件，这样我就不用担心自己编译了。
2. 如何从我的 android Java 代码调用这些文件？

谢谢！

Answer 1

Stockfish 是用 C++ 编写的，要从用 Java 编写的常规 Android 应用程序调用它，您需要

1. 依靠JNI（Java 原生接口，参见jni-sample）来解决问题。

2. 学习了如何使用 JNI 编译 Stockfish 后，您可以通过 UCI 协议与引擎进行交互：这里是 UCI Specification。

3. 然后你可以调用特定的方法（例如，评估一个位置，或者建议最好的移动）。这一切都始于发送引擎isready。如果你得到了答案，那么你就在正确的轨道上。

修改像Droidfish 这样的现有项目比从头开始要容易得多。

Answer 2

在网上搜索了很多天后，我找到了解决方案：

• 从https://stockfishchess.org/download/下载源代码，与平台无关
• 在 android studio 中创建 Native C++ 项目
• 您可以删除cpp文件夹中的native-lib.cpp文件（以及代码中的引用）
• 解压下载的文件内容，进入src文件夹，将所有文件复制到android项目的cpp文件夹中
• 在 CMakeLists.txt(cpp 文件夹) 中添加：

   add_executable(
            stockfish
    
            benchmark.cpp   evaluate.h ...(and the rest of the copied files)
    )

• 在 externalNativeBuild->cmake 的 build.gradle(app) 中添加 targets "stockfish" 如下：

externalNativeBuild {
            cmake {
                targets "stockfish"
                cppFlags ""
            }
        }

• 构建 APK
• 在文件夹 /app/.cxx/cmake/debug 中已经生成了包含可执行文件的文件夹
• 创建一个不支持 c++ 的新 android 项目
• 在新项目的 libs 文件夹中复制上述文件夹（保留名称），并在每个文件夹中删除除 stockfish 文件之外的所有内容。
• 重命名每个文件夹中的每个stockfish 文件，如lib_stockfish.so，现在文件夹应如下所示：

...
-libs
     -arm64-v8a
               -lib_stockfish.so
     -armeabi-v7a
               -lib_stockfish.so
and so on...
...

• 在 android 的 build.gradle(app) 中添加：

sourceSets {
        main {

            jniLibs.srcDirs = ['libs']
        }
    }

• 在 build.gradle(app) 的依赖项中添加：

implementation fileTree(dir: "libs", include: ["*.jar", "*.so"])

• 在manifest文件中的application标签中添加：

android:extractNativeLibs="true"

• 现在只是java中的代码：

String path = getApplicationContext().getApplicationInfo().nativeLibraryDir+"/lib_stockfish.so";


File file = new File(path);

try {
    process = Runtime.getRuntime().exec(file.getPath());
} catch (IOException e) {
    e.printStackTrace();
}



Thread outThread =  new Thread(new Runnable() {
    @Override
    public void run() {

        Process processOut = process;
        if(processOut == null){
            return;
        }


           BufferedReader out = new BufferedReader(new InputStreamReader(processOut.getInputStream()));

            String data;
            try{


                   while( (data = out.readLine()) != null ){

                    //do something with data
                   }


                } catch(IOException e){
                 
               }

            }
        });

        outThread.start();


///to give commands

String command = "uci";//or other command

command += "\n";

try {
        Process ep = process;

        if (ep != null) {
            ep.getOutputStream().write(command.getBytes());
            ep.getOutputStream().flush();
        }
    } catch (IOException e) {
        
    }