March 15th, 2022

  • Required Integrations:
    • Make sure you’ve switched to the new content system. If you haven’t, follow the integration steps listed.
    • Replace LongRangeProxy with RandomProxy.
    • Use the new getHandler, as the old one has been deprecated along with the old content system.
    • Add ExtUpdatePartyRequest message to partyRpcExt.proto to successfully build.
    • Replace Makefile line to remove duplication and clean up old scripts.
    • Replace the listed files in your 5-ext folder with the linked templates to clean up old code.

Integrations: #

  • Make sure you’ve switched to the new content system. If you haven’t, follow the integration steps listed.
    • Description: The legacy content system has now been removed, so you must be using the new content system. If your content files are located in 5-ext/content/shared, you’re using the old content system. If they’re located in 5-ext/content/src, you’re on the new system.
    • Integration step:
      • Move your content into 5-ext/content/src. Note the JSON format has also changed as content is now authored as a JavaScript array of objects.
  • Replace LongRangeProxy with RandomProxy.
    • Description: LongRangeProxy has been deleted.
    • Integration step:
      • Replace the following:
        OriginalReplacement
        LongRangeProxyRandomProxy
    • Details:
      • See 2-pragma/core/src/main/kotlin/pragma/utils/RandomProxy.kt for implementation details.
      • See 2-pragma/core/src/test/kotlin/pragma/utils/RandomProxyTest.kt for example usages.
  • Use the new getHandler, as the old one has been deprecated along with the old content system.
    • Description: ContentDataNodeService.getHandler(kClass: KClass<ContentProto>, resourcePath: String) has been removed.
    • Integration step:
      • Use ContentDataNodeService.getHandler(resourcePath: String) instead.
        OriginalReplacement
        ContentDataNodeService.getHandler(kClass: KClass<ContentProto>, resourcePath: String)ContentDataNodeService.getHandler(resourcePath: String)
  • Add ExtUpdatePartyRequest message to partyRpcExt.proto to successfully build.
    • Description: To support Party feature development, you must define the following message in the partyRpcExt proto.

    • Integration step:

      • Paste the following into partyRpcExt.proto:
      message ExtUpdatePartyRequest {
      }
      
    • Reference: 5-ext/ext-protos/src/main/shared/protos/partyRpcExt.proto

  • Replace Makefile line to remove duplication and clean up old scripts.
    • Description: Cleaning up and fixing old scripts.
    • Integration step: Replace the following line in the Makefile.
  • Replace the listed files in your 5-ext folder with the linked templates to clean up old code.
    • Description: The 5-ext/**/pom.xml files have been simplified by refactoring and removing duplication.
    • Integration steps: Replace the following files in your 5-ext folder with the related templates:
      • 5-ext/pom.xml
      • 5-ext/ext-protos/pom.xml
      • 5-ext/ext/pom.xml
      • 5-ext/ext-server/pom.xml