Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Build and Developer Experience Issues

Abierto
  • ¿Algo no está bien?
#38 2 comentarios 1 reacción 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
25/100
Tipo de issue
Nueva funcionalidad
Claridad
Necesita aclaración
Estado de actividad
Estancado
Stack tecnológico
cpp, python
Área
build-system, developer-experience, documentation, release

Línea de trabajo

Comienza con las instrucciones de compilación del README del repositorio y la sección de compatibilidad de gltf/README.md; compáralas con el paquete usd-core y los GitHub Releases enlazados. Se considera completado cuando se haya definido una ruta de compilación mínima del plugin glTF y se hayan documentado los artefactos, la compatibilidad con OpenUSD y la información de LTS; el issue no menciona archivos de implementación ni pruebas.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Introduction

While attempting to contribute tests and automation to the glTF plugin included to this repository, participants of Khronos' 3D Formats Tooling TSG expressed facing challenges in configuring and building the sources offered here. This issue collects the feedback expressed by members of the group, in the hope of facilitating onboarding and promoting contributions to this project – for which members are grateful.

Context

The 3D Formats Tooling TSG operated by Khronos was hoping to compile a list of features supported for interoperability between glTF and OpenUSD, through an accurate gap analysis and accompanying test suites against the glTF Sample Assets. The information collected by performing this exercise would have contributed knowledge to the general community about the breadth and stability of the interoperability features, and opened the door to contributions for features that may have been identified as desirable, if missing.

Although described in the project's README files, the instructions for configuring a build environment and configuring a build for producing the glTF File Format plugin for OpenUSD appeared to be more intricate than expected for the majority of potential contributors not yet familiar with OpenUSD.

This initial high barrier to entry may inadvertently cause individuals who would have been keen on contributing their expertise to the OpenUSD File Formats in this repository to invest their time in other projects where they perceive being more impactful, preventing them from further developing and supporting the valuable resources Adobe shares here.

Current Behavior

In attempting to set up their environments for contributing to the projects, members have noted that although build instructions are present in the repository's README file, they can appear challenging to potential contributors not fully versed in OpenUSD. Feedback from some include:

  • As of this writing, build artifacts for the plugins are not available through PIP packages or GitHub Releases. This currently requires contributors to build from sources, with build instructions hinting at building the all File Format plugins present in this repository when only a subset may be desired.
    • e.g. Contributing only to the glTF File Format plugin may require fewer dependencies and options than otherwise required to produce artifacts for all plugins.
  • Alignment and compatibility with OpenUSD releases is currently offered through badges at the top of README files. Contributors may wish to have more prominent access to information related to Long-Term Support of release cadence for newer versions of OpenUSD.

Key Desired Abilities

In attempting to contribute to this project, Khronos members noted they were looking to perform validation tests for glTF assets referenced within OpenUSD Stages, and faced challenges in attempting to accomplish this. In particular, they noted they were seeking to perform the following actions on this repository:

  1. Download prebuilt artifacts, in order to install via PIP the OpenUSD File Format plugins compatible with the official usd-core package. Including:
    1. Build artifacts compatible with platforms officially supported by OpenUSD (i.e. Windows, Linux, MacOS).
    2. (Optionally) Build artifacts available alongside the repository's GitHub Releases.
  2. Access developer documentation, which:
    1. Indicates the compatibility between File Format plugins and the corresponding OpenUSD release(s).
    2. States the minimal required steps to build File Format plugins (in particular, the glTF File Format plugin).
    3. Speaks to the intended to the Long-Term Support (LTS) of offered File Format plugins vis-à-vis their corresponding OpenUSD versions.

Note: Some participants expressed facing challenges when attempting to set up their environments for contribution due to File Format plugins as they were not aware of the required corresponding OpenUSD versions. Today, this information is only present through badges at the top of README files, which indicate File Format plugins are built via automation for OpenUSD 24.05 while Pixar offers 24.08 by default (with 24.11 releasing in the near future).

References

Lenguaje dominante
C++
Estrellas
398
Forks
42
Sin PR fusionados en 30 d

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de adobe/USD-Fileformat-plugins

Todos los issues de adobe/USD-Fileformat-plugins

Issues similares

Más issues de C++

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.