Package Name — шта је то, реверзна доменска нотација и захтеви

Шта је Package Name у Android-у

Package Name — је јединствени низ који Android користи за идентификацију апликације на нивоу оперативног система. Он одговара пољу package у датотеци AndroidManifest.xml и пољу applicationId у датотеци build.gradle модула апликације. Без јединственог Package Name-а, инсталација апликације на уређај корисника није могућа.

Намена Package Name-а

На уређају, Package Name служи као кључ за управљање апликацијама: систем чува податке, подешавања и кеш сваке апликације у директоријуму /data/data/[packageName]. Две апликације са истим идентификатором не могу коегзистирати — при покушају инсталације дупликата, систем предлаже уклањање постојеће.

Package Name и Application ID

У Android Gradle Plugin верзији 0.11+ појавило се раздвајање између Package Name (у манифесту) и Application ID (у build.gradle). Application ID је стварни идентификатор апликације за систем и Google Play. Package Name у манифесту се користи за разрешавање ресурса и генерисање R класе. Препоручује се да их држите истим ради једноставности.

// build.gradle (Модул: app)
android {
    defaultConfig {
        applicationId "com.example.myapplication"
        minSdkVersion 24
        targetSdkVersion 34
        versionCode 1
        versionName "1.0"
    }

    buildTypes {
        debug {
            applicationIdSuffix ".debug"
        }
    }
}

Поље applicationIdSuffix омогућава додавање суфикса Application ID-у за различите конфигурације израде. Debug верзија може имати идентификатор com.example.app.debug, што омогућава инсталацију поред производне верзије за паралелно тестирање.

Правила именовања Package Name-а

Google Play поставља строга правила за Package Name која се морају поштовати при објављивању. Идентификатор мора бити јединствен у размери целог магазина, задовољавати синтаксичке захтеве и не кршити политику коришћења трговачких марки.

Синтаксички захтеви

Package Name може садржати само латинична слова (A-Z, a-z), бројеве (0-9), тачку (.) и знак доње црте (_). Максимална дужина — 150 знакова. Сваки сегмент између тачака мора почети словом. Цртице, размаци и специјални знаци су забрањени правилима Google Play-а.

Захтеви за јединственошћу

Јединственост Package Name-а — апсолутни је захтев Google Play Store-а. Ако друга апликација већ користи изабрани идентификатор, објављивање ће бити одбијено. Google не ослобађа идентификаторе обрисаних апликација, зато је избор првог Package Name-а критична одлука за сваки пројекат програмера.

Реверзна доменска нотација и конвенције

Реверзна доменска нотација — је стандард именовања у којем се име домена компаније записује обрнутим редоследом: com.example уместо example.com. Такав систем гарантује глобалну јединственост идентификатора, јер је свако име домена по дефиницији јединствено.

Стандардни префикси

Програмери обично користе префикс који одговара TLD-у њиховог домена: com за комерцијалне организације, org за непрофитне, io за технолошке пројекте, net за мрежне услуге и решења. За личне пројекте дозвољено је коришћење com.github.username или com.email.

• com.company.app — стандардни формат за комерцијалне апликације
• org.company.app — за непрофитне и open-source пројекте
• io.company.app — популарно међу стартапима и SaaS производима
• com.github.username — за личне пројекте на GitHub-у

Конвенције за мултиплатформске пројекте

За апликације које се објављују на iOS и Android-у, препоручује се коришћење истог идентификатора на обе платформе. То поједностављује интеграцију са Firebase, AppsFlyer, Adjust и другим аналитичким системима који се везују за идентификатор пројекта. На пример, com.mycompany.myapp ће бити Bundle ID на iOS-у и Package Name на Android-у.

Подешавање Package Name-а у Android пројекту

Подешавање Package Name-а у Android пројекту укључује промену applicationId у build.gradle и одговарајуће структуре директоријума Java/Kotlin кода. Android Studio пружа алате за рефакторисање Package Name-а, али се за сложене пројекте препоручује миграција корак по корак.

Структура директоријума и Package Name

// Путања датотеке одговара Package Name-у
// com/example/myapp/MainActivity.kt

package com.example.myapp

import android.os.Bundle
import androidx.activity.ComponentActivity

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
    }
}

У Kotlin и Java, Package Name у изворним датотекама мора одговарати структури директоријума. При промени Package Name-а у build.gradle, потребно је преместити датотеке у одговарајуће директоријуме и ажурирати све декларације package и import. Android Studio то може учинити аутоматски кроз Refactor -> Move, али се за велике пројекте са десетинама датотека препоручује провера резултата након рефакторисања.

Ако пројекат користи Data Binding, View Binding или Hilt, промена Package Name-а ће такође утицати на генерисане класе. Binding класе се стварају на основу Package Name-а модула и директоријума layout. Након промене идентификатора, биће потребно поново изградити пројекат да би се ажурирале све генерисане референце. Препоручује се извршавање clean build након промене Package Name-а да би се елиминисале грешке због кешираних старих референци.

У Gradle 7.0+ појавила се подршка за namespace у build.gradle, који је заменио package у AndroidManifest.xml за потребе генерисања R класе и ресурса. Притом applicationId остаје стварни идентификатор апликације за систем и Google Play. Ово омогућава различите applicationId и namespace, што је корисно за библиотечке модуле, где је namespace фиксан, а јавни идентификатор се може мењати при изради.

За пројекте са модуларном архитектуром, промена Package Name-а једног модула може утицати на importе у другим модулима. Ако модул data има пакет com.example.data, а модул domain користи његове класе, након промене идентификатора ажурирајте importе у свим зависним модулима. Gradle прикључак за Android верзије 8.0+ поједностављује овај процес аутоматским генерисањем namespace-а из build.gradle.

Провера Package Name-а кроз код

Тренутни Application ID се може добити кроз класу BuildConfig: BuildConfig.APPLICATION_ID. Ово је згодно за условну логику у коду, везивање за окружење или приказ идентификатора на debug екранима. BuildConfig се аутоматски генерише на основу build.gradle.

// Добијање Application ID у току извршавања
val packageName = BuildConfig.APPLICATION_ID
val packageManager = packageManager
val appInfo = packageManager.getPackageInfo(packageName, 0)

println("Верзија апликације: ${appInfo.versionName} (${appInfo.versionCode})")
println("Пакет: $packageName")

Промена Package Name-а након објављивања

Промена Package Name-а након објављивања апликације у Google Play-у — операција која значи стварање потпуно новог производа. Систем не дозвољава ажурирање постојеће апликације са другим Package Name-ом, зато је одлука о промени идентификатора једнака поновном покретању пројекта у продавници.

Последице промене Package Name-а

При промени Package Name-а губе се: све оцене и рецензије, статистика инсталација, интеграција са Google Services (ако није пренета), референце на Firebase пројекат (захтева креирање новог google-services.json). Корисници неће добити аутоматско ажурирање — видеће нову апликацију у продавници.

• Оцене и рецензије — остају уз стару апликацију, не преносе се
• Статистика инсталација — се поништава за нови Package Name
• Firebase пројекти — захтевају нову конфигурацију google-services.json и поновно подешавање свих услуга
• Корисници — не добијају аутоматско ажурирање, потребно их је обавестити посебно

Када је промена Package Name-а оправдана

Промена Package Name-а може бити оправдана при ребрендирању компаније, преносу апликације на други налог програмера или при стварању засебне верзије за други регион. У сваком случају, пре промене се препоручује обавештавање корисника кроз стару апликацију и припрема плана миграције са преносом података. Без плана миграције, корисници ће изгубити приступ купљеном садржају, претплатама и сачуваним подацима апликације. Миграција укључује пренос базе података и датотека путем SharedPreferences или Room.

Пре промене Package Name-а, уверите се да је нови идентификатор јединствен и да одговара правилима именовања. Направите нову апликацију у Google Play-у са новим Package Name-ом и објавите је као засебан производ. У опису старе апликације додајте линк ка новој. Размотрите коришћење Google Play Custom Store Listing за преусмеравање корисника.