-
Notifications
You must be signed in to change notification settings - Fork 14
Required Tools
Steve Ives edited this page Apr 1, 2020
·
38 revisions
For Harmony Core development, you must have the following on a Windows development machine:
-
- 2019 or later with all updates applied.
- Although .NET Core development is technically possible in Visual Studio 2017, it is generally not in great shape and we do not recommend trying it.
-
- 3.1 or higher.
- To determine which version of the .NET Core SDK is on your machine, enter the following at a Windows command prompt:
dotnet --version
-
- 4.7.2 or higher
-
Synergy/DE 11.1.1 or higher
- Synergy/DE 32-bit
- Synergy/DE 64-bit
- Synergy DBL Integration for Visual Studio (SDI)
-
- Always use the latest version of CodeGen for Harmony Core development.
- See the CodeGen documentation for information on installing and updating CodeGen.
- To determine which version of CodeGen is on your machine, enter the following at a Windows command prompt:
codegen -checkversion
-
Harmony Core Solution Templates
- Templates to make it easy to get up and running quickly within a recommended pre-configured environment.
- To check that you have the latest version of the templates, use this command:
dotnet new -i Harmony.Core.ProjectTemplates
-
Harmony Core Solution Upgrade Tool
- A command-line tool to make it easy to upgrade existing Harmony Core projects to the latest version of Harmony Core, as well as the latest version of other dependant assemblies.
-
Internet access
- Initially required to download NuGet packages.
See Environment Setup for information on installing and trusting an SSL developer certificate and installing the Harmony Core project template.
The following tools are also recommended:
-
- A popular tool for developers to interact with and test HTTP-based services.
-
- A Chrome extension that formats and color-codes JSON data viewed in Chrome
-
Tutorial 2: Building a Service from Scratch
- Creating a Basic Solution
- Enabling OData Support
- Configuring Self Hosting
- Entity Collection Endpoints
- API Documentation
- Single Entity Endpoints
- OData Query Support
- Alternate Key Endpoints
- Expanding Relations
- Postman Tests
- Supporting CRUD Operations
- Adding a Primary Key Factory
- Adding Create Endpoints
- Adding Upsert Endpoints
- Adding Patch Endpoints
- Adding Delete Endpoints
-
Harmony Core Code Generator
-
OData Aware Tools
-
Advanced Topics
- CLI Tool Customization
- Adapters
- API Versioning
- Authentication
- Authorization
- Collection Counts
- Customization File
- Custom Field Types
- Custom File Specs
- Custom Properties
- Customizing Generated Code
- Deploying to Linux
- Dynamic Call Protocol
- Environment Variables
- Field Security
- File I/O
- Improving AppSettings Processing
- Logging
- Optimistic Concurrency
- Multi-Tenancy
- Publishing in IIS
- Repeatable Unit Tests
- Stored Procedure Routing
- Suppressing OData Metadata
- Traditional Bridge
- Unit Testing
- EF Core Optimization
- Updating a Harmony Core Solution
- Updating to 3.1.90
- Creating a new Release
-
Background Information