Переход на Android Studio

Перенос проектов в Android Studio требует адаптации к новой структуре проекта, системе сборки и функционалу IDE.

Если вы мигрируете из IntelliJ и ваш проект уже использует Gradle, вы можете открыть существующий проект из Android Studio. Если вы используете IntelliJ, но ваш проект еще не использует Gradle, вам необходимо вручную подготовить свой проект, прежде чем вы сможете импортировать его в Android Studio. Для получения дополнительной информации см. раздел Миграция из IntelliJ .

Основы Android Studio

Вот некоторые ключевые различия, которые следует учитывать при подготовке к переходу на Android Studio.

Организация проектов и модулей

Android Studio основана на IntelliJ IDEA IDE. Чтобы ознакомиться с основами IDE, такими как навигация, автодополнение кода и сочетания клавиш, см. Знакомство с Android Studio .

Android Studio организует код в проекты, которые содержат все, что определяет ваше приложение Android, от исходного кода приложения до конфигураций сборки и тестового кода. Проекты открываются в отдельных окнах Android Studio. Каждый проект содержит один или несколько модулей, которые позволяют разделить ваш проект на отдельные единицы функциональности. Модули можно независимо собирать, тестировать и отлаживать.

Дополнительную информацию о проектах и ​​модулях Android Studio см. в обзоре проектов .

Система сборки на основе Gradle

Система сборки Android Studio основана на Gradle и использует файлы конфигурации сборки, написанные на скриптах Groovy или Kotlin, что обеспечивает простоту расширения и настройки.

Проекты на основе Gradle предлагают важные возможности для разработки Android, включая следующие:

• Поддержка бинарных библиотек (AAR). Вам больше не нужно копировать исходники библиотек в свои собственные проекты; вы можете объявить зависимость , и библиотека будет автоматически загружена и объединена с вашим проектом. Это включает автоматическое объединение ресурсов, записей манифеста, правил исключения Proguard, пользовательских правил lint и т. д. во время сборки.
• Поддержка вариантов сборки , позволяющая создавать разные версии приложения (например, бесплатную и профессиональную версии) из одного и того же проекта.
• Простая конфигурация и настройка сборки . Например, вы можете извлечь имена версий и коды версий из тегов Git как часть сборки.
• Gradle можно использовать из IDE, из командной строки и с серверов непрерывной интеграции, таких как Jenkins, обеспечивая одинаковую сборку везде и всегда.

Дополнительную информацию об использовании и настройке Gradle см. в разделе Настройка сборки .

Зависимости

Зависимости библиотек в Android Studio используют объявления зависимостей Gradle и зависимости Maven для известных локальных исходных и двоичных библиотек с координатами Maven. Для получения дополнительной информации см. Объявление зависимостей .

Миграция с IntelliJ

Если ваш проект IntelliJ использует систему сборки Gradle, вы можете импортировать свой проект напрямую в Android Studio. Если ваш проект IntelliJ использует Maven или другую систему сборки, вам необходимо настроить его для работы с Gradle, прежде чем вы сможете перейти на Android Studio.

Импорт проекта IntelliJ на базе Gradle

Если вы уже используете Gradle в своем проекте IntelliJ, откройте его в Android Studio, выполнив следующие действия:

1. Нажмите Файл > Создать > Импортировать проект .
2. Выберите каталог проекта IntelliJ и нажмите OK . Ваш проект откроется в Android Studio.

Импортировать проект IntelliJ, отличный от Gradle

Если ваш проект IntelliJ еще не использует систему сборки Gradle, у вас есть два варианта импорта вашего проекта в Android Studio, которые описаны в следующих разделах:

• Создайте новый пустой проект Android Studio и скопируйте существующий исходный код в каталоги, связанные с новым проектом. Для получения дополнительной информации см. раздел о миграции путем создания нового пустого проекта .
• Создайте новый файл сборки Gradle для вашего проекта, а затем импортируйте проект и новый файл сборки в Android Studio. Для получения дополнительной информации см. раздел о миграции путем создания пользовательского файла сборки Gradle .

Миграция путем создания нового пустого проекта

Чтобы перенести свой проект в Android Studio, создав новый пустой проект и скопировав исходные файлы в новые каталоги, выполните следующие действия:

1. Откройте Android Studio и нажмите Файл > Создать > Новый проект .
2. Введите имя проекта вашего приложения и укажите место, где он должен быть создан, затем нажмите «Далее» .
3. Выберите форм-факторы, на которых работает ваше приложение, затем нажмите «Далее» .
4. Нажмите « Добавить без активности» , затем нажмите « Готово» .
5. В окне инструментов Project щелкните стрелку, чтобы открыть меню просмотра, и выберите представление Project , чтобы увидеть и изучить организацию вашего нового проекта Android Studio. Чтобы узнать больше об изменении представлений и о том, как Android Studio структурирует проекты, см. Project files .
6. Перейдите в местоположение, выбранное для нового проекта, и переместите код, модульные тесты, тесты инструментирования и ресурсы из старых каталогов проекта в правильные местоположения в новой структуре проекта.
7. В Android Studio нажмите Файл > Структура проекта , чтобы открыть диалоговое окно Структура проекта . Убедитесь, что модуль вашего приложения выбран на левой панели.
8. Внесите необходимые изменения на вкладке «Свойства» вашего проекта (например, изменив minSdk или targetSdk ).
9. Нажмите Dependencies и добавьте любые библиотеки, от которых зависит ваш проект, как зависимости Gradle. Чтобы добавить новую зависимость, нажмите Add , затем выберите тип зависимости, которую вы хотите добавить, и следуйте инструкциям.
10. Нажмите «ОК» , чтобы сохранить изменения.
11. Нажмите «Сборка» > «Создать проект» , чтобы протестировать сборку проекта и при необходимости устранить все неисправленные ошибки.

Миграция путем создания пользовательского файла сборки Gradle

Чтобы перенести проект в Android Studio, создав новый файл сборки Gradle, указывающий на существующие исходные файлы, выполните следующие действия:

1. Прежде чем начать, создайте резервную копию файлов проекта в отдельном месте, так как процесс миграции изменяет содержимое вашего проекта на месте.
2. Создайте файл в каталоге вашего проекта с именем build.gradle , если вы используете Groovy, или build.gradle.kts , если вы используете скрипт Kotlin. Этот файл содержит всю информацию, необходимую Gradle для запуска вашей сборки.

   По умолчанию Android Studio ожидает, что ваш проект будет организован так, как показано на рисунке 1.

   

   Рисунок 1. Структура проекта по умолчанию для модуля приложения Android.

   В settings.gradle для Groovy или settings.gradle.kts для скрипта Kotlin вы указываете репозитории, которые используются для поиска плагинов и зависимостей в блоках pluginManagement и dependencyResolutionManagement соответственно:

   Круто

     pluginManagement {
         repositories {
             google()
             mavenCentral()
             gradlePluginPortal()
         }
     }
     dependencyResolutionManagement {
         repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
         repositories {
             google()
             mavenCentral()
         }
     }
     rootProject.name = "Test App"
     include ':app'
     

   Котлин

     pluginManagement {
         repositories {
             google()
             mavenCentral()
             gradlePluginPortal()
         }
     }
     dependencyResolutionManagement {
         repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
         repositories {
             google()
             mavenCentral()
         }
     }
     rootProject.name = "Test App"
     include(":app")
     

   Предупреждение: Репозиторий JCenter стал доступен только для чтения 31 марта 2021 года. Более подробную информацию см. в разделе Обновление сервиса JCenter .

   Плагин Android Gradle применяет некоторые исходные наборы по умолчанию к проекту. Эти исходные наборы определяют каталоги, используемые для хранения различных типов исходных файлов . Gradle использует эти исходные наборы для определения местоположений определенных типов файлов. Если ваш существующий проект не соответствует значениям по умолчанию, вы можете либо переместить файлы туда, где они должны быть, либо изменить исходные наборы по умолчанию , чтобы Gradle знал, где их найти.

   Дополнительную информацию о настройке и персонализации файла сборки Gradle читайте в разделе Настройка сборки.

3. Далее определите, какие библиотечные проекты вы используете.

   С Gradle вам больше не нужно добавлять эти библиотеки как проекты исходного кода. Вместо этого вы можете ссылаться на них в блоке dependencies{} вашего файла сборки. Затем система сборки обрабатывает эти библиотеки за вас, включая загрузку библиотек, слияние ресурсов и слияние записей манифеста. Следующий пример добавляет операторы объявления для ряда библиотек AndroidX в блок dependencies{} файла сборки.

   Круто

   ...
   dependencies {
       implementation fileTree(dir: 'libs', include: ['*.jar'])
   
       // AndroidX libraries
       implementation 'androidx.core:core-ktx:1.16.0'
       implementation 'androidx.appcompat:appcompat:1.7.1'
       implementation 'androidx.cardview:cardview:1.0.0'
       implementation 'com.google.android.material:material:1.7.0'
       implementation 'androidx.gridlayout:gridlayout:1.1.0'
       implementation 'androidx.leanback:leanback:'
       implementation 'androidx.mediarouter:mediarouter:1.8.0'
       implementation 'androidx.palette:palette-ktx:1.0.0'
       implementation 'androidx.recyclerview:recyclerview:1.4.0'
       implementation 'androidx.annotation:annotation:1.9.1'
   
       // Note: these libraries require that the Google repository has been declared
       // in the pluginManagement section of the top-level build.gradle file.
   }

   Котлин

   ...
   dependencies {
       implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar"))))
   
       // AndroidX libraries
       implementation("androidx.core:core-ktx:1.16.0")
       implementation("androidx.appcompat:appcompat:1.7.1")
       implementation("androidx.cardview:cardview:1.0.0")
       implementation("com.google.android.material:material:1.7.0")
       implementation("androidx.gridlayout:gridlayout:1.1.0")
       implementation("androidx.leanback:leanback:")
       implementation("androidx.mediarouter:mediarouter:1.8.0")
       implementation("androidx.palette:palette-ktx:1.0.0")
       implementation("androidx.recyclerview:recyclerview:1.4.0")
       implementation("androidx.annotation:annotation:1.9.1")
   
       // Note: these libraries require that the Google repository has been declared
       // in the pluginManagement section of the top-level build.gradle.kts file.
   }

   Чтобы получить помощь в определении правильных операторов объявления для ваших библиотек, выполните поиск в репозитории Google Maven или Maven Central .
4. Сохраните файл build.gradle , затем закройте проект в IntelliJ. Перейдите в каталог проекта и удалите каталог .idea и все файлы IML в вашем проекте.
5. Запустите Android Studio и нажмите Файл > Создать > Импортировать проект .
6. Найдите каталог вашего проекта, выберите созданный вами файл build.gradle или build.gradle.kts , а затем нажмите кнопку «ОК» , чтобы импортировать ваш проект.
7. Нажмите «Сборка» > «Создать проект» , чтобы протестировать файл сборки, создав свой проект, и устранить все обнаруженные ошибки.

Следующие шаги

После переноса проекта в Android Studio узнайте больше о сборке с помощью Gradle и запуске приложения в Android Studio, прочитав статью Сборка и запуск приложения .

В зависимости от вашего проекта и рабочего процесса, вы также можете захотеть узнать больше о контроле версий, управлении зависимостями и настройке Android Studio. Чтобы начать использовать Android Studio, прочитайте Знакомство с Android Studio .

Настроить контроль версий

Android Studio поддерживает множество систем контроля версий, включая Git, Mercurial и Subversion. Другие системы контроля версий можно добавлять через плагины.

Если ваше приложение уже находится под контролем исходного кода, вам может потребоваться включить его в Android Studio. В меню VCS нажмите Включить интеграцию с контролем версий и выберите соответствующую систему контроля версий.

Если ваше приложение не находится под контролем исходного кода, вы можете настроить его после импорта вашего приложения в Android Studio. Используйте параметры меню VCS Android Studio, чтобы включить поддержку VCS для желаемой системы контроля версий, создать репозиторий, импортировать новые файлы в систему контроля версий и выполнить другие операции контроля версий:

1. В меню Android Studio VCS нажмите Включить интеграцию с контролем версий .
2. Выберите систему контроля версий для связи с корнем проекта из меню, затем нажмите OK . Меню VCS теперь отображает ряд параметров контроля версий на основе выбранной вами системы.

Примечание: для настройки и изменения контроля версий можно также использовать пункт меню Файл > Настройки > Контроль версий .

Дополнительную информацию о работе с контролем версий см. в справочнике по контролю версий IntelliJ .

Подписание приложений

Если ранее использовался сертификат отладки, он может быть обнаружен в процессе импорта. В этом случае Android Studio продолжает ссылаться на этот сертификат. В противном случае конфигурация отладки использует хранилище ключей отладки, сгенерированное Android Studio, с использованием известного пароля и ключа по умолчанию с известным паролем, расположенного в $HOME/.android/debug.keystore . Тип сборки отладки настроен на автоматическое использование этой конфигурации отладки при запуске или отладке проекта из Android Studio.

Аналогично, процесс импорта может обнаружить существующий сертификат выпуска. Если ранее не был определен сертификат выпуска, добавьте конфигурацию подписи выпуска в файл build.gradle или build.gradle.kts или используйте пункт меню Build > Generate Signed APK , чтобы открыть Generate Signed APK Wizard . Для получения дополнительной информации о подписании вашего приложения см. раздел Sign your app .

Настройте максимальный размер кучи Android Studio

По умолчанию Android Studio имеет максимальный размер кучи 1280 МБ. Если вы работаете над большим проектом или в вашей системе много оперативной памяти, вы можете повысить производительность , увеличив максимальный размер кучи .

Обновления программного обеспечения

Android Studio обновляется отдельно от плагина Gradle, инструментов сборки и инструментов SDK. Вы можете указать, какие версии вы хотели бы использовать с Android Studio.

По умолчанию Android Studio автоматически обновляется каждый раз, когда выходит новая стабильная версия, но вы можете выбрать более частые обновления и получать предварительные или бета-версии.

Дополнительную информацию об обновлении Android Studio и использовании предварительных и бета-версий можно найти в разделе «Обновления» .