Renaming an Android SDL3 Project Переименование проекта SDL3 для Android

A guide to updating the package identifier, directory structure, Java activity, application display name, and CMake target name in your Android SDL3 project. Руководство по обновлению идентификатора пакета, структуры директорий, Java-класса, отображаемого названия и имени цели CMake в проекте SDL3 для Android.

You can use these steps on your existing setup or start with one of the pre-configured template repositories: Вы можете выполнить эти шаги на своем проекте или скачать один из готовых шаблонов:

Step 1: Update CMakeLists.txt Target & Project Name Шаг 1: Обновление имени проекта и цели в CMakeLists.txt

Open CMakeLists.txt in the root of your project and set your custom project name: Откройте CMakeLists.txt в корне вашего проекта и укажите новое имя проекта:

project(android-app-sdl3-c)

If you change your compiled shared library target name (e.g., app): Если вы меняете имя вашей скомпилированной библиотеки (например, app):

add_library(app SHARED src/main.c)
Important: Важно: The library name passed to add_library must match the array value returned in MyActivity.java (Step 4). Имя библиотеки, передаваемое в add_library, должно совпадать со значением, возвращаемым в MyActivity.java (Шаг 4).

Step 2: Update build.gradle Шаг 2: Обновление build.gradle

Open android-project/app/build.gradle and update the namespace and applicationId fields to your new package ID (e.g., com.example.myapp): Откройте android-project/app/build.gradle и укажите новый ID пакета (например, com.example.myapp) в полях namespace и applicationId:

android {
    namespace "com.example.myapp"
    compileSdkVersion 36

    defaultConfig {
        applicationId 'com.example.myapp'
        // ...
    }
}

Step 3: Rename the Java Package Folder Шаг 3: Переименование папки Java-пакета

Rename the physical directory path inside app/src/main/java/ so it reflects your new package identifier: Переименуйте пути к папкам внутри app/src/main/java/ в соответствии с вашим новым идентификатором пакета:

android-project\app\src\main\java\com\example\myapp

Step 4: Update MyActivity.java Шаг 4: Обновление MyActivity.java

Open android-project\app\src\main\java\com\example\myapp\MyActivity.java, update the package declaration at the top, and ensure the native library name matches your target in CMakeLists.txt: Откройте android-project\app\src\main\java\com\example\myapp\MyActivity.java, укажите новый пакет и убедитесь, что имя нативной библиотеки совпадает с именем из CMakeLists.txt:

package com.example.myapp;

import org.libsdl.app.SDLActivity;

public class MyActivity extends SDLActivity {
    @Override
    protected String[] getLibraries() {
        return new String[] { "app" };
    }
}

Step 5: Update AndroidManifest.xml Шаг 5: Обновление AndroidManifest.xml

Open android-project\app\src\main\AndroidManifest.xml and update the android:name attribute of your activity to match the new package path: Откройте android-project\app\src\main\AndroidManifest.xml и измените атрибут android:name для activity:

<activity android:name="com.example.myapp.MyActivity"

Step 6: Set Application Display Name Шаг 6: Установка отображаемого названия приложения

To change the app name displayed on the Android home screen, open android-project\app\src\main\res\values\strings.xml and set the app_name string: Чтобы изменить имя приложения, отображаемое на главном экране Android, откройте android-project\app\src\main\res\values\strings.xml и задайте значение app_name:

<resources>
    <string name="app_name">My App</string>
</resources>

Support My Work Поддержать проект

If these tutorials helped you, consider buying me a coffee! Если эти туториалы вам помогли, вы можете поддержать автора.

Sberbank (Russia only) Сбербанк (только для РФ)

Sberbank SBP QR Code

Direct transfer via phone number (Russia only) Перевод по номеру телефона (только для РФ)

+7 (917) 212-29-59

USDT TRC20

USDT TRC20 QR Code

Support via Cryptocurrency Поддержка криптовалютой

TMtY1YifNf6FKvgeFmqKGQR4NStKr3csGp