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

(#17) updated TargetFramework to net6.0-windows7.0 #18

Open
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

nils-a
Copy link

@nils-a nils-a commented Mar 20, 2023

  • Bumped GitExtensions.Extensibility
  • Referenced Microsoft.VisualStudio.Composition
  • Referenced Microsoft.VisualStudio.Threading

fixes #17
fixes #16

* Bumped GitExtensions.Extensibility
* Referenced Microsoft.VisualStudio.Composition
* Referenced Microsoft.VisualStudio.threading
Copy link
Member

@RussKie RussKie left a comment

Choose a reason for hiding this comment

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

I think it looks good.

Comment on lines 23 to 24
<PackageReference Include="Microsoft.VisualStudio.Composition" Version="17.4.16" />
<PackageReference Include="Microsoft.VisualStudio.threading" Version="17.5.22" />
Copy link
Member

Choose a reason for hiding this comment

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

Why do we need these two?

Copy link
Member

Choose a reason for hiding this comment

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

In Plugin Manager we have System.ComponentModel.Composition with 6.0.0 and that's enough. I think we had some problems when referencing VS MEF in Plugin Manager.

Copy link
Member

Choose a reason for hiding this comment

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

That's a good point. We can only use versions used in the main app: https://github.com/gitextensions/gitextensions/blob/master/Packages.props#L18-L20
But since we'd be referencing the main app, I'm curious why we need these here.

Copy link
Member

Choose a reason for hiding this comment

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

Hm, we just reference main app specific dlls. It doesn't add indirect references to the build, right? And so we need some MEF to be able compile the plugin dll.

Maybe could add all/some package reference from main app to the GitExtensions.Extensibility

Copy link
Author

Choose a reason for hiding this comment

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

I "only" copied those from the Gerrit plugin. I was wondering, though, why it was those instead of System.ComponentModel.Composition.
I'm perfectly happy to change those for something better. Referencing Microsoft.VisualStudio.* feels weird.

Copy link
Member

Choose a reason for hiding this comment

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

I would remove these completely unless we have a strong justification. In case we do, we should document it here.

Copy link
Member

@maraf maraf left a comment

Choose a reason for hiding this comment

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

Looks good in general!

Comment on lines 23 to 24
<PackageReference Include="Microsoft.VisualStudio.Composition" Version="17.4.16" />
<PackageReference Include="Microsoft.VisualStudio.threading" Version="17.5.22" />
Copy link
Member

Choose a reason for hiding this comment

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

In Plugin Manager we have System.ComponentModel.Composition with 6.0.0 and that's enough. I think we had some problems when referencing VS MEF in Plugin Manager.

<!-- path is relative to $(ProjectDir) -->
<GitExtensionsDownloadPath>..\..\..\gitextensions.shared</GitExtensionsDownloadPath>
<!-- 'latest' or 'v3.1' (= tag from GitHub releases) or 'v3.1.0.5877' (= build number from AppVeyor)-->
<GitExtensionsReferenceVersion>latest</GitExtensionsReferenceVersion>
Copy link
Member

Choose a reason for hiding this comment

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

It would be good to add a section to readme under Good Practices stating that GitExtensionsReferenceVersion used for local development should be synchronized with GitExtensions.Extensibility package version, so local dev loop and published package targets the same version of Git Extensions.

It's out of scope of this PR, so if you don't want to write it, I can do it in a separate PR

Copy link
Author

@nils-a nils-a Mar 21, 2023

Choose a reason for hiding this comment

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

I'm not so good on words, but I'll give it a try.

I'm uncertain if I get what you mean, here.
GitExtensions.Extensibility "only" ensures a local copy of Git Extensions exists for local development. It "only" provides the preBuild and the postBuild targets, does it not?

Copy link
Member

Choose a reason for hiding this comment

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

It also adds a dependency in the built nuget package and we use this dependency to validate that the package is intended for the current main app version (we still have gaps in this area, but in general 0.3 means targeting Git Extensions v4).

As we don't have a stable API yet, you typically need to "hack" into what Git Extensions give you in the current plugin API, and so it is important to build against "similar" version that you the plugin to run in (most of my plugins needs at least recompilation between main app version upgrades).

Using "latest" can be dangerous, because it may download even preview version.

* TargetFramework is now `net6.0-windows`
* Removed package references to Microsoft.VisualStudio.Composition & Microsoft.VisualStudio.Threading
* added a reference to the System.ComponentModel.Composition.dll that is provided by Git Extensions

Also, I bumped the AppVeyor image to VS2022 to get support for net6.0.
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.

Migrate the template to .NET Vanilla generated project from this template does not compile.
3 participants