345 lines
7.3 KiB
Markdown
345 lines
7.3 KiB
Markdown
|
# Upgrade project react-simple-poll to v1.11.0
|
||
|
|
||
|
Date: 10/16/2020
|
||
|
|
||
|
## Findings
|
||
|
|
||
|
Following is the list of steps required to upgrade your project to SharePoint Framework version 1.11.0. [Summary](#Summary) of the modifications is included at the end of the report.
|
||
|
|
||
|
### FN001001 @microsoft/sp-core-library | Required
|
||
|
|
||
|
Upgrade SharePoint Framework dependency package @microsoft/sp-core-library
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm i -SE @microsoft/sp-core-library@1.11.0
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN001002 @microsoft/sp-lodash-subset | Required
|
||
|
|
||
|
Upgrade SharePoint Framework dependency package @microsoft/sp-lodash-subset
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm i -SE @microsoft/sp-lodash-subset@1.11.0
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN001003 @microsoft/sp-office-ui-fabric-core | Required
|
||
|
|
||
|
Upgrade SharePoint Framework dependency package @microsoft/sp-office-ui-fabric-core
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm i -SE @microsoft/sp-office-ui-fabric-core@1.11.0
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN001004 @microsoft/sp-webpart-base | Required
|
||
|
|
||
|
Upgrade SharePoint Framework dependency package @microsoft/sp-webpart-base
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm i -SE @microsoft/sp-webpart-base@1.11.0
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN001005 @types/react | Required
|
||
|
|
||
|
Remove SharePoint Framework dependency package @types/react
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm un -S @types/react
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN001006 @types/react-dom | Required
|
||
|
|
||
|
Remove SharePoint Framework dependency package @types/react-dom
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm un -S @types/react-dom
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN001007 @types/webpack-env | Required
|
||
|
|
||
|
Remove SharePoint Framework dependency package @types/webpack-env
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm un -S @types/webpack-env
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN001010 @types/es6-promise | Required
|
||
|
|
||
|
Remove SharePoint Framework dependency package @types/es6-promise
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm un -S @types/es6-promise
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN001021 @microsoft/sp-property-pane | Required
|
||
|
|
||
|
Upgrade SharePoint Framework dependency package @microsoft/sp-property-pane
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm i -SE @microsoft/sp-property-pane@1.11.0
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN001022 office-ui-fabric-react | Required
|
||
|
|
||
|
Upgrade SharePoint Framework dependency package office-ui-fabric-react
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm i -SE office-ui-fabric-react@6.214.0
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN002001 @microsoft/sp-build-web | Required
|
||
|
|
||
|
Upgrade SharePoint Framework dev dependency package @microsoft/sp-build-web
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm i -DE @microsoft/sp-build-web@1.11.0
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN002002 @microsoft/sp-module-interfaces | Required
|
||
|
|
||
|
Upgrade SharePoint Framework dev dependency package @microsoft/sp-module-interfaces
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm i -DE @microsoft/sp-module-interfaces@1.11.0
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN002003 @microsoft/sp-webpart-workbench | Required
|
||
|
|
||
|
Upgrade SharePoint Framework dev dependency package @microsoft/sp-webpart-workbench
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm i -DE @microsoft/sp-webpart-workbench@1.11.0
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN002009 @microsoft/sp-tslint-rules | Required
|
||
|
|
||
|
Upgrade SharePoint Framework dev dependency package @microsoft/sp-tslint-rules
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm i -DE @microsoft/sp-tslint-rules@1.11.0
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN002013 @types/webpack-env | Required
|
||
|
|
||
|
Install SharePoint Framework dev dependency package @types/webpack-env
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm i -DE @types/webpack-env@1.13.1
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN002014 @types/es6-promise | Required
|
||
|
|
||
|
Install SharePoint Framework dev dependency package @types/es6-promise
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm i -DE @types/es6-promise@0.0.33
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN002015 @types/react | Required
|
||
|
|
||
|
Install SharePoint Framework dev dependency package @types/react
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm i -DE @types/react@16.8.8
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN002016 @types/react-dom | Required
|
||
|
|
||
|
Install SharePoint Framework dev dependency package @types/react-dom
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm i -DE @types/react-dom@16.8.3
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
### FN006004 package-solution.json developer | Optional
|
||
|
|
||
|
In package-solution.json add developer section
|
||
|
|
||
|
In file [./config/package-solution.json](./config/package-solution.json) update the code as follows:
|
||
|
|
||
|
```json
|
||
|
{
|
||
|
"solution": {
|
||
|
"developer": {
|
||
|
"name": "Contoso",
|
||
|
"privacyUrl": "https://contoso.com/privacy",
|
||
|
"termsOfUseUrl": "https://contoso.com/terms-of-use",
|
||
|
"websiteUrl": "https://contoso.com/my-app",
|
||
|
"mpnId": "000000"
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
```
|
||
|
|
||
|
File: [./config/package-solution.json](./config/package-solution.json)
|
||
|
|
||
|
### FN010001 .yo-rc.json version | Recommended
|
||
|
|
||
|
Update version in .yo-rc.json
|
||
|
|
||
|
In file [./.yo-rc.json](./.yo-rc.json) update the code as follows:
|
||
|
|
||
|
```json
|
||
|
{
|
||
|
"@microsoft/generator-sharepoint": {
|
||
|
"version": "1.11.0"
|
||
|
}
|
||
|
}
|
||
|
```
|
||
|
|
||
|
File: [./.yo-rc.json](./.yo-rc.json)
|
||
|
|
||
|
### FN012012 tsconfig.json include property | Required
|
||
|
|
||
|
Update tsconfig.json include property
|
||
|
|
||
|
In file [./tsconfig.json](./tsconfig.json) update the code as follows:
|
||
|
|
||
|
```json
|
||
|
{
|
||
|
"include": [
|
||
|
"src/**/*.tsx"
|
||
|
]
|
||
|
}
|
||
|
```
|
||
|
|
||
|
File: [./tsconfig.json](./tsconfig.json)
|
||
|
|
||
|
### FN017001 Run npm dedupe | Optional
|
||
|
|
||
|
If, after upgrading npm packages, when building the project you have errors similar to: "error TS2345: Argument of type 'SPHttpClientConfiguration' is not assignable to parameter of type 'SPHttpClientConfiguration'", try running 'npm dedupe' to cleanup npm packages.
|
||
|
|
||
|
Execute the following command:
|
||
|
|
||
|
```sh
|
||
|
npm dedupe
|
||
|
```
|
||
|
|
||
|
File: [./package.json](./package.json)
|
||
|
|
||
|
## Summary
|
||
|
|
||
|
### Execute script
|
||
|
|
||
|
```sh
|
||
|
npm i -SE @microsoft/sp-core-library@1.11.0 @microsoft/sp-lodash-subset@1.11.0 @microsoft/sp-office-ui-fabric-core@1.11.0 @microsoft/sp-webpart-base@1.11.0 @microsoft/sp-property-pane@1.11.0 office-ui-fabric-react@6.214.0
|
||
|
npm i -DE @microsoft/sp-build-web@1.11.0 @microsoft/sp-module-interfaces@1.11.0 @microsoft/sp-webpart-workbench@1.11.0 @microsoft/sp-tslint-rules@1.11.0 @types/webpack-env@1.13.1 @types/es6-promise@0.0.33 @types/react@16.8.8 @types/react-dom@16.8.3
|
||
|
npm un -S @types/react @types/react-dom @types/webpack-env @types/es6-promise
|
||
|
npm dedupe
|
||
|
```
|
||
|
|
||
|
### Modify files
|
||
|
|
||
|
#### [./config/package-solution.json](./config/package-solution.json)
|
||
|
|
||
|
In package-solution.json add developer section:
|
||
|
|
||
|
```json
|
||
|
{
|
||
|
"solution": {
|
||
|
"developer": {
|
||
|
"name": "Contoso",
|
||
|
"privacyUrl": "https://contoso.com/privacy",
|
||
|
"termsOfUseUrl": "https://contoso.com/terms-of-use",
|
||
|
"websiteUrl": "https://contoso.com/my-app",
|
||
|
"mpnId": "000000"
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
```
|
||
|
|
||
|
#### [./.yo-rc.json](./.yo-rc.json)
|
||
|
|
||
|
Update version in .yo-rc.json:
|
||
|
|
||
|
```json
|
||
|
{
|
||
|
"@microsoft/generator-sharepoint": {
|
||
|
"version": "1.11.0"
|
||
|
}
|
||
|
}
|
||
|
```
|
||
|
|
||
|
#### [./tsconfig.json](./tsconfig.json)
|
||
|
|
||
|
Update tsconfig.json include property:
|
||
|
|
||
|
```json
|
||
|
{
|
||
|
"include": [
|
||
|
"src/**/*.tsx"
|
||
|
]
|
||
|
}
|
||
|
```
|