Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Build name convention standardization #6423

Conversation

efb4f5ff-1298-471a-8973-3d47447115dc
Copy link
Member

@efb4f5ff-1298-471a-8973-3d47447115dc efb4f5ff-1298-471a-8973-3d47447115dc commented Dec 20, 2024

Build name convention standardization

Pull Request Type

  • Bugfix
  • Feature Implementation
  • Documentation
  • Other

Related issue

#6415

Description

This PR changes the following:

  • We were using a mix match of hyphens and underscores so this changes all builds to use hyphens instead of underscores. Why hyphens? Most release builds were using hyphens and for nightly builds it was about 50/50 so i opted for hyphens as most normal users (the ones that use release builds) are used to seeing hyphens. Certain platforms have their own naming conventions (e.g. .deb and .rpm) when thats the case we will use those conventions.
  • Some build names didnt include the .zip extension so i added them
  • if file name contains portable then the following structure is used, platform-architecture-portable. There was a mix of this structure and platform-portable-architecture being used.
  • all zip and 7z builds include portable in the name now except macos builds

Additional context

I will create a PR for our website that will pull the now adjusted release builds. That PR will be drafted as it should be merged right before release.

This is part 2 of making changes in these workflow.
Upcoming parts:

  • Part 3: Group all builds based on platform
  • Part 4: Investigate if all builds have .zip and .7z equivalents

@FreeTubeBot FreeTubeBot enabled auto-merge (squash) December 20, 2024 17:32
@github-actions github-actions bot added the PR: waiting for review For PRs that are complete, tested, and ready for review label Dec 20, 2024
@absidue
Copy link
Member

absidue commented Dec 20, 2024

We should probably stick with underscores for the artifacts that electron-builder also uses underscores e.g. the deb files where using underscores to separate the name, version and architecture in the deb file name is a convention .

@efb4f5ff-1298-471a-8973-3d47447115dc efb4f5ff-1298-471a-8973-3d47447115dc added PR: changes requested and removed PR: waiting for review For PRs that are complete, tested, and ready for review labels Dec 20, 2024
@efb4f5ff-1298-471a-8973-3d47447115dc efb4f5ff-1298-471a-8973-3d47447115dc added PR: waiting for review For PRs that are complete, tested, and ready for review and removed PR: changes requested labels Dec 22, 2024
@efb4f5ff-1298-471a-8973-3d47447115dc
Copy link
Member Author

Applied standard naming conventions where it wasnt being applied before.

@efb4f5ff-1298-471a-8973-3d47447115dc efb4f5ff-1298-471a-8973-3d47447115dc added PR: WIP and removed PR: waiting for review For PRs that are complete, tested, and ready for review labels Dec 22, 2024
@efb4f5ff-1298-471a-8973-3d47447115dc
Copy link
Member Author

efb4f5ff-1298-471a-8973-3d47447115dc commented Dec 23, 2024

applied WIP as it still need some more changes

@efb4f5ff-1298-471a-8973-3d47447115dc efb4f5ff-1298-471a-8973-3d47447115dc added PR: waiting for review For PRs that are complete, tested, and ready for review and removed PR: WIP labels Dec 28, 2024
@efb4f5ff-1298-471a-8973-3d47447115dc
Copy link
Member Author

ready for review!

.github/workflows/build.yml Show resolved Hide resolved
@@ -322,26 +322,26 @@ jobs:
uses: actions/upload-artifact@v4
if: startsWith(matrix.os, 'macos') && startsWith(matrix.runtime, 'osx-x64')
with:
name: freetube-${{ steps.versionNumber.outputs.result }}-mac-x64.zip
name: freetube-${{ steps.versionNumber.outputs.result }}-mac-x64-portable.zip
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not objecting this but I found that projects rarely got portable suffix to zips & dmg for mac
But it's still fine to be extra clear

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I can revert it if you want. I only added this because some of our portable builds did have it and others not

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ya I think it's better to revert.
There is no portable concept for macOS apps (mostly). The data is stored in user directory anyway.
I would even argue that the windows one isn't portable as well. Since the data isn't stored inside the same folder as the app folder (and no way to change that). It's just another way of installation but the data isn't "portable".

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I will revert it for macOS

I would even argue that the windows one isn't portable as well. Since the data isn't stored inside the same folder as the app folder (and no way to change that). It's just another way of installation but the data isn't "portable".

A conversation i had before opening this PR

image

Copy link
Member

@ChunkyProgrammer ChunkyProgrammer left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note: these changes could break some workflows for some of the unofficial downloads.

We should probably notify the maintainer of the PortableApps version of FreeTube that this change was made as well as other maintainers of unofficial downloads if we think their workflow might need to be modified for these changes

.github/workflows/release.yml Show resolved Hide resolved
@efb4f5ff-1298-471a-8973-3d47447115dc efb4f5ff-1298-471a-8973-3d47447115dc removed the PR: waiting for review For PRs that are complete, tested, and ready for review label Dec 29, 2024
@efb4f5ff-1298-471a-8973-3d47447115dc
Copy link
Member Author

efb4f5ff-1298-471a-8973-3d47447115dc commented Dec 29, 2024

Note: these changes could break some workflows for some of the unofficial downloads.

We should probably notify the maintainer of the PortableApps version of FreeTube that this change was made as well as other maintainers of unofficial downloads if we think their workflow might need to be modified for these changes

@ChunkyProgrammer i have notified all maintainers of the unofficial downloads through GH/email except for WAPT (not sure how to properly contact the package maintainer) and Homebrew (i think this is Pika though)

@ryand56
Copy link

ryand56 commented Dec 30, 2024

Thanks for letting us know about the changes, though no changes will be needed on our end as we are building from source now.

@PikachuEXE
Copy link
Collaborator

My homebrew tab also builds from source = not relying on those names
https://github.com/PikachuEXE/homebrew-FreeTube/blob/master/.github/workflows/release-manual-trigger.yml

@efb4f5ff-1298-471a-8973-3d47447115dc efb4f5ff-1298-471a-8973-3d47447115dc added PR: waiting for review For PRs that are complete, tested, and ready for review and removed PR: changes requested labels Dec 30, 2024
@rddim
Copy link
Contributor

rddim commented Dec 30, 2024

@ChunkyProgrammer and @efb4f5ff-1298-471a-8973-3d47447115dc

Thank you very much for the notification. I'm not affected from the new changes because I use the only the final releases.

@efb4f5ff-1298-471a-8973-3d47447115dc
Copy link
Member Author

Are there still things that we need to consider? Are there maybe some reservations about this PR that i can address?

Copy link
Member

@absidue absidue left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We'll need to remember to update the files in the flathub repo that reference the linux zip files.

@FreeTubeBot FreeTubeBot merged commit 8c33113 into FreeTubeApp:development Jan 1, 2025
5 checks passed
@github-actions github-actions bot removed the PR: waiting for review For PRs that are complete, tested, and ready for review label Jan 1, 2025
@efb4f5ff-1298-471a-8973-3d47447115dc
Copy link
Member Author

efb4f5ff-1298-471a-8973-3d47447115dc commented Jan 1, 2025

We'll need to remember to update the files in the flathub repo that reference the linux zip files.

Im on it!

@efb4f5ff-1298-471a-8973-3d47447115dc efb4f5ff-1298-471a-8973-3d47447115dc deleted the standardize-build-naming-convention branch January 1, 2025 22:22
SuperAKWA pushed a commit to SuperAKWA/FreeTube that referenced this pull request Jan 24, 2025
* standardize names for builds

* use .deb and .rpm standard pkg name convention

* include portable in name for 7z and zip builds

* revert portable naming for mac builds

* change names in flatpak workflow
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

8 participants