# Integración con GitHub ### 1. Cree una cuenta en GitHub. ### 2. Cree un repositorio (su aplicación): GitHub > Dashboard > + > New repository. * Repository name: mauimusic * Marque: Add a README file * Eliga una licencia ### 3. Clone su repositorio en su carpeta de desarrollo. Si ya tiene un código preexistente haga copia del contenido a la nueva carpeta clonada: ``` cd /home/user/Devel/Apps git clone https://github.com/user/mauimusic.git ``` ### 4. Instale y haga login en GitHub: ``` sudo zypper install gh openssh-askpass-gnome gh auth login ``` Seleccione: * GitHub.com > HTTPS > Autenticate Git with your GitHub credentials > Login with a web browser. * Copie el código de autenticación. * Presione tecla Enter. * Ingrese usuario y contraseña de GitHub * Pege el código de autenticación. * Clic botón Authorize github. Configure su correo y nombre: ``` git config --global user.email "tucorreo@servidor.com" git config --global user.name "tu nombre" ``` ### 5. Haga su primer commit con el nuevo contenido: ``` cd /home/user/Devel/Apps/mauimusic git add * git commit -m "first commit" git push origin main ``` Para el segundo y siguientes commits: ``` cd /home/user/Devel/Apps/mauimusic git add * git commit -m "my commit" git push ``` ### 6. Cree el token de acceso a GitHub. GitHub > Dashboard > pulse sobre la imagen de perfil (superior derecha) > Settings > Developer settings > Personal access tokens > Tokens (classic) > Generate new token (classic) * Note: GitHub Token * Expiration: No expiration * Scopes: todos * Generate token * Copie el nuevo token. No podrá verlo de nuevo, por lo que debe guardarlo. ### 7. Cree un token en Open Build Service. Your Home Project > pulse sobre la imagen de perfil (superior derecha) > Your profile > Manage Your Tokens > Create Token > * Type: workflow * Description: OBS Personal Access Token * SCM Token: pega el token de GitHub obtenido en el punto 6. * Path for Workflows Configuration File (no modificar): .obs/workflows.yml * Create Apunte su OBS Personal Access Token: * Secret: Copie y guarde. * Token trigger url: Copie y guarde. ### 8. Cree en GitHub un webhook para su aplicación. Seleccione: * GitHub > click sobre imagen de perfil (superior derecha) > Your repositories > su aplicación (mauimusic) * De las opciones superiores (code, Issues, Pull requests...) seleccione: Settings > Webhooks > Add webhook * Payload URL: Pegar su "Token trigger url" del punto 7. * Content type: application json * Secret: Pegar su "Secret" del punto 7. * Seleccione: Send me everything. * Add webhook. ### 9. Crear .obs/workflows.yml * Abra la página de código de su aplicación (mauimusic): Selecciones Code o click sobre imagen de perfil (superior derecha) > Your repositories > su aplicación (mauimusic). * Add file > Create new file * Pegar en la caja de texto "mauimusic/Name your file". Sustituya Name your file por: .obs/workflows.yml * Creará la carpeta oculta ".obs" y el archivo workflows.yml a la vez. Incluya como contenido de workflows.yml: ``` rebuild_master: steps: - rebuild_package: project: home:usuario:subproyecto1 package: mauimusic filters: event: push workflow: steps: - branch_package: source_project: home:usuario source_package: mauimusic target_project: home:usuario:subproyecto2 filters: event: tag_push ``` En el archivo anterior se ha incluido: * rebuild\_master: para compilar cada commit en subproyecto1 y paquete mauimusic. * workflow: para compilar cada nueva publicación de versión o tag de su aplicación en subproyecto2 y paquete mauimusic. Haga clic en Commit changes > Commit changes. ### 10. Descarge los cambios a su carpeta local: ``` cd /home/user/Devel/Apps/mauimusic git pull ``` ### 11. Para compilar cada commit: * Si no lo ha hecho, cree su paquete subproyecto1 > su paquete. * Paquete > Add an empty file or service > File URL e indique la URL de cualquier archivo online. Es necesario para crear un servicio (fichero \_service) válido. Por ejemplo, File URL: * Abra Subproyecto1 > Paquete > \_service e incluya: ``` git https://github.com/user/mauimusic.git main 0.1+git%cd.%h mauimusic enable *.tar gz ``` Sustituya user y mauimusic. * Añada mauimusic.spec o supaquete.spec ``` %define mauikit_version 3.0.1 Name: mauimusic Version: 0.1.0 Release: 0 License: LGPL-3.0 Summary: Discover and listen music URL: https://github.com/user/mauimusic Source: %{name}-%{version}.tar.gz %if 0%{?sle_version} == 150400 && 0%{?is_opensuse} ExcludeArch: x86_64 %endif %if 0%{?sle_version} == 150500 && 0%{?is_opensuse} ExcludeArch: x86_64 %endif BuildRequires: gcc-c++ BuildRequires: cmake BuildRequires: extra-cmake-modules BuildRequires: fdupes BuildRequires: AppStream BuildRequires: cmake(Qt5QuickCompiler) BuildRequires: cmake(Qt5Core) BuildRequires: cmake(Qt5Quick) BuildRequires: cmake(Qt5Qml) BuildRequires: cmake(Qt5Widgets) BuildRequires: cmake(KF5I18n) BuildRequires: cmake(KF5CoreAddons) BuildRequires: cmake(MauiKit) = %{mauikit_version} BuildRequires: cmake(MauiKitFileBrowsing) = %{mauikit_version} Requires: qt5qmlimport(QtQuick.Controls.2) Requires: qt5qmlimport(QtQuick.Layouts.1) Requires: mauikit = %{mauikit_version} Requires: mauikit-filebrowsing = %{mauikit_version} %description Discover and listen music. %prep %autosetup -p1 %build %cmake_kf5 -d build %cmake_build %install %kf5_makeinstall -C build %kf5_post_install %fdupes %{buildroot}%{_prefix} %files %license licenses/* %doc README.md %{_bindir}/mauimusic %{_datadir}/applications/*.desktop %{_datadir}/metainfo/*.xml %{_datadir}/icons/hicolor/*/*/* %changelog ``` Para actualizar: Open Build Service > Subproyecto > Paquete > Trigger services ### 12. Para compilar cada nueva versión o tag de su aplicación: Para publicar una nueva versión en GitHub: ``` cd /home/user/Devel/Apps/mauimusic git tag -a v0.1.0 -m "Releasing version v0.1.0" git push origin v0.1.0 ``` Crear Subproyecto2 > su paquete > \_service como en el punto 11 e incluir: ``` @PARENT_TAG@ https://github.com/user/mauimusic.git git @PARENT_TAG@ *.tar gz ``` Para actualizar: Open Build Service > Subproyecto > Paquete > Trigger service