Android open source code что это такое

Android от А до Я: Что такое открытый исходный код и открытое ПО (open source)

Открытое программное обеспечение (open-source software) предназначено для свободного доступа к исходному коду для всех желающих. Существуют разные лицензии с разными условиями использования от GPL (GNU General Public License) и до более лояльной Apache License. Первая разрешает бесплатное распространение при условии использования этой же лицензии для последующей продукции. Вторая не требует обязательного распространения готового продукта и открытости исходного кода. Android использует обе. Внутри продолжение рассказал об открытом исходном коде и открытом ПО.

Ядро Linux, которое используется в ОС, попадает под действие GPL. Это означает, что все изменения исходного кода должны быть доступны общественности после официального выхода софта. На практике это должно выглядеть следующим образом: такие производители как HTC, Samsung, Motorola, выпуская новое устройство, обязаны делать открытый доступ к исходному коду с моменты выпуска этого устройства. В большинстве своем производители железа немного затягивают с этим.

Исходный код для ОС Android как правило попадает под действие Apache License. Каждый может загрузить исходный код и изменить его, при этом нет необходимости делать код доступным для всех. По этой причине Android не могут изменить или усовершенствовать HTC Sense или MotoBlur. Несмотря на то, что подобная ситуация не нравится многим пользователям, она не может быть изменена в силу коммерческих причин. Если бы производители делали доступными все свои секреты, то отпала бы финансовая причина создавать различные инновации для опережения соперников в конкурентной борьбе. Таким образом, использование более лояльной лицензии является полностью оправданным. Выпуск новых устройств регулярно подтверждает это.

Источник

Загрузка и сборка AOSP

Решил поделиться своей инструкцией как собрать AOSP (Android Open Source Project). Эта инструкция будет полезна тем кто хочет посмотреть что-же внутри Android и возможно заняться системной разработкой. В любом случаи эти знания полезны для понимания самого Android, как раз для этого и решил собрать AOSP.

Проект собираю на elementary 5.1 OS Ubuntu 18.04 LTS (bionic), пытался на MacOS собрать, но так и не удалось. Для исходников и сборки нужно 200 Гб на жестком диске (лучше SSD, на обычном производительность сильно проседает). Так же много времени, я потратил чтобы скачать и собрать около 20 часов, частично виновата «слабая» конфигурация моего компьютера. У меня установлено всего 8 Гб оперативной памяти, но увеличил размер swap-а до 16 Гб.

Загружаем AOSP

Установить требуемые пакеты для загрузки и сборки :

Создаем папку и качаем repo утилиту для загрузки исходного кода

Исходники AOSP состоят из отдельных проектов с собственными git-репозиториями, repo позволяет упросить всю загрузку всех проектов и разложить по нужным папкам.

• -u — урл git-репозитория с манифестом
• -b — ветка (самая последняя на текущий момент)
• —depth — скачивать только одну ветку (если не использовать, то для каждого репозитория скачается весь индекс, что увеличит время загрузки и место на диске)

Выбрал самую последнюю версию Android 10. Не использую develop или master, так как там устаревший манифест и проект скорее не соберется.

Теперь можно запустить загрузку исходников AOSP

• -c — скачивать только текущую ветку манифеста (как указал выше — android-10.0.0_r45)
• -j — количество потоков, обычно указывается столько доступно процессоров
• —no-tags — не скачивать тэги с репозитариев
• —no-clone-bundle — не пытаться качать clone.bundle (упакованная репа, которая уменьшить время на загрузку, но не у всех сервер формирует этот bundle),

—no-clone-bundle можно попробовать убрать, что в теории ускорит скачивание, но у меня заваливается с 404 ошибкой

Скачивание может занять минуты и часы, теперь с repo закончили, если нужно почитать больше то ищите в официальной документации: https://source.android.com/setup/develop/repo

Сборка

Настраиваем среду разработчика:

x86_64 — указывается под какой девайс собирать, в данном случае Generic x86_64 подходит для эмуляторов, если будете запускать на Nexus девайсах, то ищите детали в документации https://source.android.com/setup/build/building#choose-a-target

eng — тип сборки (сокращение от engineering), с максимальными логами и дополнительными утилитами для отладки. Другие тип сборки думаю не особо интересны

Для сборки java файлов увеличиваем Heap size, если этого не сделать, то сборка всего завалится с StackOverflow ошибкой:

Так же можно добавить в .bashrc чтобы постоянно не повторять команду

Все, теперь готовы к сборке:

Можно не использовать CCACHE, что уменьшит количество занимаемого места на диске, но увеличит время повторной сборки. На моем «слабом» компьютере сборка заняла где-то 16 часов.

После окончания сборки, запускаем эмулятор:

-show-kernel — выводить уведомления в консоль

Если нажать Enter, то попадем в консоль эмулятора

Если эмулятор не запустился, нужно будет проверить что включена виртуализация

Готовим IDE для отладки

Для начала необходимо сгенериовать проект для IDE, проект генерируется для IDEA. Собираем модули для генератора:

Чтобы весь AOSP затолкать в проект, то просто запускаем генератор

Но сгенерированный IDEA проект будет очень «тяжелым». Одно открытие и индексация занимает достаточно много времени. Лучше генерировать IDEA проект для каждого отдельного проекта, например для Android фреймворка

Весь список доступных проектов можно посмотреть в

Открываем сгенерированный base.iml (находится в папке frameworks/base) в IDEA. Дальше нужно настроить Java, только нужно подключать java без библиотек, так как у AOSP-а свои реализации.

Запускаем отладку

Для начала необходимо запустить monitor

возможно потребуется дополнительно поставить jre
sudo apt install openjdk-8-jre-headless

Выбираем процесс, который будем отлаживать. В monitor-е выбираем процесс и справа от порта процесса появится /8700, это как раз порт отладчика, к нему можно подключаться через IDEA.
Все системные штуки находятся в system_process. Его мы и будем отлаживать.

monitor один самых полезных инструментов при отладке и исследования работы AOSP

В проекте добавляем новую Remote конфигурацию, только указываем 8700 порт. Именно к этому порту и будем подключаться

Запускаем Debug (Run → Debug)

Чтобы удостоверится, что все подключилось поставьте брейкпоинт в frameworks/base/services/core/java/com/android/server/wm/ActivityTaskManagerService.java файле на метод:

и запустить любое приложение на эмуляторе (например, Settings).

Источник

Open Source Your Android Code — The Complete Guide

ADA | Adam Deconstructs Android

Aug 29, 2017 · 8 min read

9/17/17 Update: JitPack.io appears to be a fast and easy alternative to open source Android code vs. the method below by integrating directly with GitHub. I have not tested JitPack so please share your feedback in the comments if you’ve implemented it.

You’ve spent hours building cool shit. What’s the next step? By open sourcing your work you’ll (hopefully) provide valuable code to the Android community, receive constructive feedback, and collaborate on building something better than what you originally had.

The current state of open sourcing for Android is unintuitive, involving integrating multiple services, waiting for manual approvals, and before this post, spending hours Googling obscure steps. That’s why I created a beginning-to-end guide to expedite the process.

The more open sourced code, the better.

Implementation

I will walk through each step of how I open sourced a CustomRippleView library for Android.

Place code inside an Android Archive Library (AAR) — Step 1 of 6

Besides open sourcing, AARs are useful when building multiple apps or versions with the same components.

About

• Structurally the same as an Android app module
• Includes source code, resource files, manifest (unlike JAR)
• Compiles into Android Archive (AAR) rather than into APK
• Post to some maven repository where devs can pull it as a dependency through Gradle (can also convert an app to a module)
• Code Overlap — The app module will take precedence over a library if a resource ID is defined in both, library defined first will take precedence between libraries.

Implementation

If you’re creating a standalone library outside an existing app you’ll want to both create a new project to host the library module as well as test the library module in an existing app.

1. Build the open sourced library module in an existing project so that you can test the code as you go.

a) Create library module

Click the plus or File > New > Module > Android Library > provide unique Library Module Name ( customrippleview)

b) Ensure local library module shows in project and compile local library in the app module.

build.gradle ( app module)

Add tools:replace=”android:name” to the app module’s Manifest file.

2. Create a new Android project to host the open source code by itself so that it can be uploaded to bintray

Create the default app module with app following the name ( customrippleviewapp) to differentiate the app module name from the open source library module we’ll create in the next step.

• Application name: CustomRippleViewApp
• Company domain: com.ebay.customrippleviewapp ( needs to be a domain you own in order to get approved for open sourcing)
• Package name: com.ebay.customrippleviewapp

3. Add your library module (refer to step 1A above)

4. Place the open source code inside new library module created

5. Remove original app module

Right-click on app module > Open Module Settings > remove original app module.

6. Choose resources to make public (Optional)

All resources default to public: By declaring at least one resource public it makes the rest private

res > values > public.xml

Publish library publicly on GitHub with licensing and Docs — Step 2 of 6

Apache License 2.0 is one of the most popular, similar to the MIT License, but provides grant of patent rights from contributors to users. Apache 2.0 is commonly found in Android, Apache, and Swift.

Make sure library module ( customrippleview/) and build.gradle are not in the ignore list list and edit .gitignore to only contain library module files added.

Bintray and Sonatype Setup — Step 3 of 6

You only need to go through this painful steps once to setup your bintray account. Praise the lord! As this isn’t difficult, but the most annoying step.

Bintray Implementation

2. Create new repository

a) Add New Repository → Type: Maven → Default Licenses: Apache 2.0

b) Use lowercase naming convention: customrippleview

3. Enable auto signing

Enter Repository → Edit → General Settings → select GPG sign uploaded files automatically

a) Generate keys (Only done once for bintray account)

In terminal for project:

Fill in Real name, Email address, and passphrase. If command does not work, run following command to install gpg and retry the command above.

View keys created

Upload the public key to keyservers. Call the following command and replace PUBLIC_KEY_ID with value after 2048 in the pub line.

Export both public and private key.

Enter your passphrase when prompted for private key.

Copy and paste public and private keys into bintray: Under profile Edit > GPG Signing. Make sure to copy and paste from beginning and end tags or else bintray will not accept the keys.

Sonatype Implementation

This step requires filling a Jira ticket. If you thought you could escape Jira in your free coding time, you’re mistaken. It’s not too bad, as both times I’ve submitted a ticket they’ve approved it within the same day.

3. Provide bintray your Sonatype OSS username

In your bintray profile Edit > Accounts > Sonatype OSS User: _____________

Prepare Project for Upload — Step 4 of 6

Prepare Library Module With Bintray

1. Add Jcenter and Maven dependency

Add to project’s build.gradle (not app or library build.gradle)

2. Define your bintray username, api key, and GPG Passphrase.

This info should be secure, which is why we’re adding it to local.properties which should not be tracked in GitHub as it is commonly ignored at the start of an Android project in the .gitignore file.

3. Add repository information and build scripts

Update library’s build.gradle with repository information and add scripts for building library files and uploading the built files to bintray.

4. If using Kotlin in your code, disable Javadocs in library’s build.gradle

Upload to jcenter— Step 5 of 6

Why is jcenter better than maven central?

• Delivers library through CDN → faster loading
• Largest Java Repository on earth
• “Friendly” UI (perhaps in comparison)

Implementation

1. Upload to bintray/jcenter (Once Sonatype Open Source Project Repository Hosting request is approved)

Expected Result: BUILD SUCCESSFUL

Expected Result: BUILD SUCCESSFUL

I kept getting the BUILD FAILED response when attempting to upload. After many hours cursing at my terminal I realized even with this message, the package was being uploaded, so check the bintray package UI.

2. Sync to Jcenter for easy one line implementation in Android

3 hrs — How is this not automated too?!

a) Under the uploaded package settings select Add to JCenter

b) Select Host my snapshot…, fill in group id for package, and Select Send

Once approved, you’ll receive an email.

In the meantime you can check by searching on bintray which will also show when your package is hosted.

3. Maintaining library

Linking to jcenter only needs to be done once. Moving forward, any package changes (updates, deletes), will be reflected in jcenter 2–3 min later.

• Updates: Change the libraryVersion in library module and re-upload using Step 5, part 1.
• Deleting: Remove each version from bintray before removing the entire package.

Use In Project — Step 6 of 6

Declare the library in gradle and call the desired files.

build.gradle ( app module)

• Group_Id — com.ebay.customrippleview(package name followed by group name)
• Artifact_Id: customrippleview
• Version: 1.0

Resources

• JitPack.io — JitPack is an Android specific open sourcing solution that appears to work seamlessly with GitHub repositories. For a premium, JitPack also provides private library hosting. I haven’t given it a try, but thanks to Rakshak and Vikarti for calling it out in the comments below!
• The Cheese Factory Blog — How to distribute your own Android library through jCenter and Maven Central from Android Studio. BIG thanks! There were details that changed since this was published in 2015, but it was a great place to start.
• Android Studio — Create an Android Library
• bintray
• sonatype
• sonatype — request to host new open source project ( only works when logged in to sonatype)
• bintray documentation — Including your Package in JCenter
• CustomRippleView GitHub sample and JCenter hosting

I’m Adam Hurwitz — hit the clapping hands icon and check out the rest of my writing if you enjoyed the above | Thanks!

Источник